Hexo + GitHub Pages 部署博客（完整教程）

在搭建个人博客的过程中，Hexo + GitHub Pages 是最受欢迎的方案之一。
本文将详细介绍如何从零开始完成配置与部署，帮助你快速拥有一个属于自己的在线博客。

<!--more-->

一、使用 Git 连接 GitHub 账户（推荐 SSH 方式）

在部署过程中，我们需要让本地环境能够与 GitHub 通信。推荐使用 SSH
连接，避免每次都输入账号密码。

1. 打开命令行（Windows 用 Git Bash 或 cmd，macOS/Linux
   用终端），输入以下命令生成 SSH 密钥：

   ssh-keygen -t rsa -C "your_email@example.com"

   注意：将 your_email@example.com 替换为你注册 GitHub 的邮箱。

2. 按 3 次回车（默认路径、默认不设密码），密钥文件会保存在：

   • Windows: C:\Users\你的用户名\.ssh\
   • macOS/Linux: ~/.ssh

3. 找到 id_rsa.pub 文件（公钥），用文本编辑器打开并复制全部内容。

4. 登录 GitHub → 右上角头像 → Settings → SSH and GPG keys →
   New SSH key。

   • Title 填一个容易记的名字（如 “My PC”）
   • Key 粘贴公钥内容 → 点击 Add SSH key
     

5. 测试是否成功连接：

   ssh -T git@github.com

   输入 yes 后，若提示：

   Hi 用户名! You've successfully authenticated...
   

   即表示 SSH 配置成功。

---

二、配置 Hexo 与 GitHub 关联

完成 GitHub 连接后，我们需要修改 Hexo 配置文件，实现自动部署。

1. 修改 _config.yml

在博客根目录下找到 _config.yml，滚动到文件末尾，修改 deploy 部分：

deploy:
  type: git
  repo: https://github.com/用户名/用户名.github.io.git   # 仓库地址（可用 SSH：git@github.com:用户名/用户名.github.io.git）
  branch: main   # GitHub 仓库默认分支，新版是 main，旧版可能是 master

2. 安装部署插件

确保在博客目录下执行：

npm install hexo-deployer-git --save

3. 配置 Git 用户信息

在命令行里设置全局 Git 用户信息（首次配置时需要）：

git config --global user.name "yourname"
git config --global user.email "youremail@example.com"

检查是否配置正确：

git config user.name
git config user.email

---

三、发布博客到 GitHub Pages

完成配置后，就可以将本地博客推送到 GitHub Pages 了。

1. 新建测试文章（可选）：

   hexo new "我的第一篇 Hexo 博客"

   文章会保存在 source/_posts 文件夹下（Markdown 格式）。

   

2. 生成静态文件：

   hexo clean   # 清理旧文件
   hexo g       # 等同于 hexo generate，生成新静态页面

   

3. 部署到 GitHub：

   hexo d   # 等同于 hexo deploy

   如果是 SSH 方式，不需要输入账号密码。

   

4. 访问博客：
   等待 1~5 分钟，打开浏览器输入：

   https://用户名.github.io
   

   即可访问。

---

四、常见问题与解决方法

1. 找不到 GitHub 用户名？
   打开 GitHub 个人主页，网址里 / 后面的就是你的用户名，例如：
   https://github.com/octocat → 用户名是 octocat。
   

2. Git 配置问题
   设置 Git 用户时，注意 user.name 和 "yourname"
   之间要有空格，例如：

   git config --global user.name "yourname"
   git config --global user.email "youremail@example.com"

3. 上传失败或连接超时
   可能需要配置网络代理，或者使用 SSH 方式连接 GitHub。

---

总结

至此，你已经学会了：

• 通过 SSH 连接 GitHub\
• 修改 Hexo 配置，实现自动部署\
• 使用 hexo g 和 hexo d 将博客推送到 GitHub Pages

这样，你就拥有了一个完全属于自己的个人博客！ 🚀