hexo + github 个人博客部署

一个详细、完善的 Hexo 博客部署教程，不仅涵盖了基本的安装、配置、生成与部署步骤，还增加了常见问题的解决、主题设置和使用 SSH 方式部署的补充说明。

---

一、安装 Hexo、Node.js 和 Git 部署插件

1.1 安装 Node.js

确保你的系统已经安装 Node.js（建议使用 LTS 版本），可以从 Node.js 官网 下载并安装。

1.2 全局安装 Hexo CLI

使用 npm 安装 Hexo CLI：

npm install -g hexo-cli  # 全局安装 Hexo CLI

1.3 初始化 Hexo 博客

在合适的目录下初始化一个新博客：

hexo init myblog         # 初始化博客目录
cd myblog
npm install              # 安装依赖

1.4 安装 Git 部署插件

安装 Hexo 的 Git 部署插件，用于将生成的静态文件推送到 GitHub：

npm install hexo-deployer-git --save

---

二、配置 Hexo

2.1 修改博客配置文件

打开项目根目录下的 _config.yml 文件，找到或添加 deploy 部分，并根据你的 GitHub 仓库信息进行修改：

deploy:
  type: git
  repo: https://github.com/你的GitHub用户名/你的仓库名.git
  branch: main  # 或者 master，取决于 GitHub Pages 的分支设置
  # 可选：自定义提交信息
  message: "部署 Hexo 博客，更新于 $(date '+%Y-%m-%d %H:%M:%S')"

注意：如果你希望使用 SSH 方式部署，请将 repo 修改为类似 git@github.com:你的GitHub用户名/你的仓库名.git 的格式，并确保你的本机已配置好 SSH key 并添加至 GitHub。

2.2 常见配置项补充

• url：配置你的博客访问域名，例如 https://yourdomain.com，方便生成正确的链接。
• root：如果你的博客部署在子目录下（例如 GitHub Pages 的 username.github.io/repo），请设置相应的根路径。
• 其他设置：可根据需求调整 Hexo 的其它配置，如文章摘要长度、分页数等。

---

三、生成静态文件并部署到 GitHub

3.1 生成静态文件

在 Hexo 项目根目录下运行：

hexo clean && hexo g

这条命令会清理之前生成的文件，然后根据源文件生成最新的静态页面。

3.2 部署到 GitHub

生成静态文件后，运行以下命令部署：

hexo d

部署过程中，如果是首次部署，可能会要求输入 GitHub 账号和密码，或者你需要提前配置 SSH key。

3.3 自动化部署脚本

你可以将生成与部署命令写入脚本文件，便于以后快速部署。示例脚本 deploy.sh 如下：

#!/bin/bash
# 清理旧文件
hexo clean
# 生成新文件
hexo g
# 部署到 GitHub Pages
hexo d

记得给脚本执行权限：

chmod +x deploy.sh

以后只需运行 bash deploy.sh 即可完成部署。

---

四、使用主题美化界面

4.1 选择并安装主题

Hexo 拥有大量开源主题，你可以在 Hexo 主题库 中选择适合你的主题。本文以 fuild 主题为例，安装步骤大致如下：

1. 下载 fuild 主题并放入博客的 themes 目录下。
2. 修改根目录下的 _config.yml 文件，将 theme 参数设置为 fuild：

   theme: fuild

3. 根据主题的文档进行个性化配置，如配色、导航、社交链接等。

4.2 主题二次定制

若需要进一步美化博客，可以修改主题提供的配置文件（通常位于 themes/fuild/_config.yml）或直接调整主题源代码。推荐查阅主题的 README 及文档以了解更多自定义选项。

---

五、常见问题与解决方案

5.1 SSH 部署遇到权限问题

• 确保本机生成 SSH key，并在 GitHub 上添加该公钥。
• 检查 repo 是否设置为 SSH 格式（如 git@github.com:xxx/xxx.git）。

5.2 部署后页面未更新

• 检查 _config.yml 中的 branch 配置是否正确。
• 查看 GitHub Pages 的部署设置，确认分支名称与 GitHub Pages 服务对应。
• 可以尝试手动刷新浏览器缓存，或在仓库设置中重新触发 Pages 部署。

5.3 文章生成与排版问题

• 若文章中出现格式问题，检查 Markdown 语法是否正确。
• 更新 Hexo 及相关依赖版本，确保与主题的兼容性。

---

六、部署后的扩展与维护

6.1 自动部署

你可以利用 CI/CD 工具（如 GitHub Actions）实现每次更新自动生成并部署 Hexo 博客，减少手动操作。GitHub Actions 允许你在代码 push 后自动运行脚本完成静态文件生成和部署，具体流程可参考相关文档。

6.2 数据备份与版本控制

• 定期备份 Hexo 源文件以及 _config.yml 配置。
• 利用 Git 的版本控制功能，方便回滚和对比修改历史。

---

这样，一个完整且详细的 Hexo 部署到 GitHub Pages 的流程就完成了！通过本文档，你不仅可以轻松部署博客，还能在后续根据需求进行主题定制与自动化维护，让博客更加稳定和美观。希望这份教程能帮助你打造个性化、专业的博客！