HEXO 部署到 GitHub Pages 教程

本文将详细介绍如何将 HEXO 部署到 GitHub Pages。通过这些步骤，您可以轻松地将您的 HEXO 博客托管在 GitHub Pages 上。

1. 安装 HEXO

首先，确保您已经安装了 Node.js 和 Git。然后，通过 npm 安装 HEXO：

1

npm install -g hexo-cli

2. 创建 HEXO 项目

在您想要创建博客的位置运行以下命令：

1
2
3

hexo init blog
cd blog
npm install

3. 配置 _config.yml

编辑项目根目录下的 _config.yml 文件，找到并修改以下内容：

1
2
3
4

deploy:
  type: git
  repo: https://github.com/<your-username>/<your-repo>.git
  branch: main

将 <your-username> 替换为您的 GitHub 用户名，将 <your-repo> 替换为您想要用于托管博客的仓库名。

4. 安装 HEXO 部署插件

安装用于将 HEXO 部署到 GitHub Pages 的插件：

1

npm install hexo-deployer-git --save

5. 生成静态文件

生成博客的静态文件：

1

hexo generate

或者使用简写：

1

hexo g

6. 部署到 GitHub Pages

将生成的静态文件部署到 GitHub Pages：

1

hexo deploy

或者使用简写：

1

hexo d

7. 推送代码到 GitHub

为了确保您的博客代码和配置也能在 GitHub 上进行管理，您需要将代码推送到同一个仓库中：

1
2
3
4
5
6

git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/<your-username>/<your-repo>.git
git push -u origin main

8. 访问您的博客

完成上述步骤后，您可以通过 https://<your-username>.github.io/<your-repo> 访问您的博客。

常见问题

1. 部署失败

如果在部署过程中遇到问题，可以尝试以下方法：

• 检查 _config.yml 中的 repo 和 branch 配置是否正确。
• 确保您在 GitHub 上已经创建了对应的仓库。

2. 自定义域名

如果您希望使用自定义域名，可以在 source 目录下创建一个名为 CNAME 的文件，并在其中写入您的自定义域名，例如：

1

www.yourdomain.com

然后重新生成并部署：

1

hexo g -d

参考资料

• HEXO 官方文档
• GitHub Pages 官方文档

通过上述步骤，您可以将 HEXO 博客成功部署到 GitHub Pages 上。如果有任何问题，请参考官方文档或在社区中寻求帮助。

许可协议

本文采用 署名-非商业性使用-相同方式共享 4.0 国际 许可协议，转载请注明出处。

分享文章