Hexo是一款快速、简洁且高效的静态博客框架，使用Markdown进行写作，并能够通过各种主题和插件扩展功能。将Hexo博客部署到GitHub，不仅可以轻松托管个人博客，还能够利用GitHub Pages提供的免费服务。本文将详细介绍如何将Hexo部署到GitHub的整个过程，帮助你快速搭建属于自己的博客。
环境准备
在开始之前，请确保你已经完成了以下环境配置：
- 安装Node.js：Hexo依赖Node.js，因此需要确保你的系统中已安装。可以通过命令行输入
node -v和npm -v来检查是否已成功安装。 - 安装Git：Git是Hexo博客与GitHub交互的工具，确保你的系统中已安装并配置了Git。
Hexo安装
在你的计算机上进行Hexo的安装，按照以下步骤操作：
-
创建一个新的文件夹： bash mkdir my-blog cd my-blog
-
安装Hexo： 使用npm命令安装Hexo： bash npm install hexo-cli -g
-
初始化Hexo： 通过命令行进入创建的文件夹，然后初始化Hexo项目： bash hexo init cd my-blog npm install
-
运行Hexo： bash hexo server
访问
http://localhost:4000即可查看你的博客。
创建GitHub仓库
在将Hexo博客部署到GitHub之前，你需要创建一个新的GitHub仓库：
- 登录你的GitHub账户，点击右上角的
+号，选择New repository。 - 输入你的仓库名称，建议与博客名称相同。选择
Public选项，然后点击Create repository。
Hexo配置
在Hexo项目中进行必要的配置，以便能够将其与GitHub连接：
-
配置
_config.yml： 在项目根目录下找到并编辑_config.yml文件，设置url为你创建的GitHub仓库地址。 yaml url: https://<your_username>.github.io/<your_repository> -
添加部署配置： 在
_config.yml文件中添加以下内容： yaml deploy: type: git repo: https://github.com/<your_username>/<your_repository>.git branch: main确保替换为你的GitHub用户名和仓库名称。
部署Hexo博客到GitHub
一旦完成所有配置，就可以将Hexo博客部署到GitHub：
-
生成静态文件： 运行以下命令，生成静态网页文件： bash hexo generate
-
部署到GitHub： 运行以下命令，将生成的文件推送到GitHub： bash hexo deploy
如果提示输入用户名和密码，请使用你的GitHub凭证。
-
查看效果： 部署成功后，访问
https://<your_username>.github.io/<your_repository>，即可查看你的博客。
常见问题解答（FAQ）
1. Hexo部署到GitHub后无法访问？
确保在GitHub上设置了正确的仓库权限，仓库需要为公共（Public）。同时，检查_config.yml中的URL是否配置正确。
2. 部署后博客样式不正确？
这可能是由于主题未正确安装导致的。请检查themes目录下是否有相应的主题，并在_config.yml中配置相应的主题。
3. 如何更新Hexo博客？
每次更新博客内容后，运行以下命令： bash hexo generate hexo deploy
即可将最新的内容更新到GitHub。
4. Hexo支持自定义域名吗？
支持。在_config.yml中，设置url为自定义域名，确保将域名的CNAME记录指向GitHub的服务器。
结论
通过上述步骤，你已经成功将Hexo博客部署到GitHub，享受简单、免费的博客托管服务。随着博客内容的增加，你也可以通过hexo new <title>命令快速添加新文章，持续分享你的想法和创作。希望本文对你有所帮助！
