GitHub搭建Hexo教程

最新推荐文章于 2025-06-19 14:28:17 发布

原创最新推荐文章于 2025-06-19 14:28:17 发布 · 346 阅读

CC 4.0 BY-SA版权

文章标签：

1 篇文章

订阅专栏

本文介绍了Hexo博客框架，它能快速生成静态网页。搭建前需准备本地的Node.js和Git环境，以及GitHub环境并创建特定命名的仓库。接着阐述了搭建Hexo的步骤，包括安装、新建文件、生成页面和本地运行，最后说明了将其部署到GitHub的方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Hexo简介

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。
这里写图片描述

1.本地环境搭建
安装 Hexo 相当简单。然而在安装前，您必须检查电脑中是否已安装下列应用程序：

$ npm install -g hexo-cli

2.github环境搭建

安装git的内容跳过，不是本文章介绍范围，默认你已经安装好git并且配置好了SSH

2.1. 创建代码仓库

注意：仓库名应该为：github用户名.github.io 这个用户名使用你的GitHub帐号名称代替，这是固定写法，必须这样写。

创建代码仓库

1.安装 Hexo 完成后，请执行下列命令，Hexo 将会在指定文件夹中新建所需要的文件。

$ hexo init <folder>
$ cd <folder>
$ npm install

2.新建完成后，指定文件夹的目录如下：

├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

3.生成静态页面

$ hexo clean
$ hexo g

4.本地运行

$ hexo server

server可简写为s

　指令功能参考官方文档

然后打开浏览器，输入地址 localhost:4000 即可在本地看到效果如图
这里写图片描述

Hexo 提供了快速方便的一键部署功能，让您只需一条命令就能将网站部署到服务器上。

$ hexo deploy

在开始之前，您必须先在 _config.yml 中修改参数，一个正确的部署配置中至少要有 type 参数

注意： YAML依靠缩进来确定元素间的从属关系。因此，请确保每个deployer的缩进长度相同，并且使用空格缩进。

Git部署需要安装 [hexo-deployer-git]。

$ npm install hexo-deployer-git --save

修改配置。（请注意一定要缩进）

deploy:
  type: git
  repo: <repository url>
  branch: [branch]
  message: [message]

参数	描述
`repo`	库（Repository）地址
`branch`	分支名称。如果您使用的是 GitHub 或 GitCafe 的话，程序会尝试自动检测。
`message`	自定义提交信息 (默认为 `Site updated: {% raw %}{{ now('YYYY-MM-DD HH:mm:ss') }}{% endraw %}`)