Hexo部署GitHub博客流程

一、环境准备与初始化

1. 安装必要环境：确保已安装Node.js和Git，这是运行Hexo框架的基础。

2. 安装Hexo CLI：

   npm install -g hexo-cli

3. 初始化Hexo项目：

   hexo init myblog
   cd myblog
   npm install

4. 安装部署插件：安装最新版hexo-deployer-git（2024年推荐使用）

   npm install hexo-deployer-git --save

二、SSH密钥配置（关键步骤）

1. 生成SSH密钥对：

   ssh-keygen -t rsa -C "[email protected]"

   按提示操作，通常直接回车使用默认设置即可。

2. 添加SSH密钥到ssh-agent：

   eval "$(ssh-agent -s)"
   ssh-add ~/.ssh/id_rsa

3. 将公钥添加到GitHub：

   • 复制公钥内容：cat ~/.ssh/id_rsa.pub
   • 登录GitHub，进入Settings → SSH and GPG keys → New SSH key，粘贴公钥内容。

4. 验证SSH连接：

   ssh -T [email protected]

   看到”Hi username! You’ve successfully authenticated…”表示成功。

三、GitHub仓库设置

1. 创建专用仓库：在GitHub上创建名为username.github.io的仓库（username替换为你的GitHub用户名）。

2. （可选）配置GitHub Actions自动化：2024年更推荐使用GitHub Actions实现自动化部署，创建.github/workflows/pages.yml文件。

四、Hexo配置与部署

1. 修改配置文件：编辑项目根目录下的_config.yml，设置deploy部分：

   deploy:
     type: git
     repo: [email protected]:username/username.github.io.git
     branch: main  # 注意：GitHub 2024年默认分支为main而非master

2. 首次部署：

   hexo clean && hexo g -d

   此命令会生成静态文件并部署到GitHub仓库。

3. 验证部署：等待几分钟后，访问https://username.github.io查看博客是否成功部署。

五、发布文章流程（2024年标准）

1. 创建新文章：

   hexo new "文章标题"

   这将在source/_posts目录下生成Markdown文件。

2. 编辑文章：使用Markdown编辑器完善文章内容、添加标签和分类。

3. 本地预览（可选）：

   hexo server #仅修改文章时用

   访问http://localhost:4000查看效果。

4. 生成并部署：

   hexo clean && hexo g -d

   此命令会清理旧文件、生成新静态文件并自动推送到GitHub。

5. （推荐）使用GitHub Actions自动化：配置好Actions后，只需推送源文件到源仓库，Actions会自动构建并部署到GitHub Pages。

注意事项（2024年更新）

• GitHub默认分支已从master改为main，配置文件中需指定branch: main。
• 更推荐使用GitHub Actions实现自动化部署，避免本地频繁操作。
• 确保SSH密钥正确配置，这是免密码部署的关键。
• Hexo 7.0+版本与GitHub Pages兼容性良好，建议使用最新版。

完成以上步骤后，你的Hexo博客将成功部署到GitHub Pages，并可通过https://username.github.io访问。每次发布新文章只需执行创建、编辑、生成部署三步即可。