Hexo 和 GitHub Pages 搭配是搭建个人博客非常受欢迎的选择，它能让你免费拥有一个可高度定制的网站。下面这份保姆级教程会带你一步步完成搭建。

希望这份详细的指南能帮助你顺利搭建起自己的小天地！祝你玩得开心！

🛠️ 环境准备与检查

在开始之前，我们需要准备好“施工场地”，即安装必要的软件并确认它们正常工作。

  1. 安装 Node.js

    • 作用：Hexo 是基于 Node.js 的博客框架，需要它来运行。
    • 步骤：访问 Node.js 官网下载 LTS（长期支持）版本并安装。安装时一路默认设置即可。
    • 检查步骤：安装完成后，打开命令提示符或 PowerShell，输入以下命令，如果显示版本号则说明安装成功。
      1
      2
      node -v
      npm -v

  2. 安装 Git

    • 作用：用于版本控制以及将你本地写好的博客代码部署到 GitHub。
    • 步骤：访问 Git 官网下载并安装，使用默认选项即可。
    • 检查步骤：在命令行中输入以下命令，显示版本号即成功。
      1
      git --version

🚀 创建本地博客并预览

环境准备好后，我们就可以在本地创建并预览博客了。

  1. 安装 Hexo CLI：在命令行中执行以下命令，全局安装 Hexo 命令行工具。

    1
    npm install -g hexo-cli

  2. 初始化博客项目：为你博客创建一个文件夹并初始化。

    1
    2
    3
    4
    5
    # 创建一个名为 my-blog 的文件夹并进入
    hexo init my-blog
    cd my-blog
    # 安装必要的依赖包
    npm install

  3. 本地预览：完成初始化后，执行以下命令启动本地服务器。

    1
    hexo server  # 可以简写为 hexo s

    接着在浏览器中打开 http://localhost:4000，你就能看到你的博客雏形了！按 Ctrl+C 可以停止服务器。

常用命令速查：

功能 完整命令 简写命令
生成静态文件 hexo generate hexo g
启动服务器 hexo server hexo s
部署到网站 hexo deploy hexo d
新建文章 hexo new post "文章标题" hexo n post "文章标题"

📦 部署到 GitHub

本地博客运行成功后，下一步就是把它放到 GitHub 上，成为真正的个人网站。

  1. 创建 GitHub 仓库

    • 登录你的 GitHub 账号。
    • 点击右上角的 “+” 号，选择 “New repository”。
    • 关键：仓库名必须严格遵循 你的用户名.github.io 的格式。例如，如果你的 GitHub 用户名是 zhangsan，那么仓库名就应该是 zhangsan.github.io。

  2. 配置 SSH 密钥（推荐）：这能让你的电脑安全地访问 GitHub，避免每次部署都输入密码。

    • 生成密钥：在命令行中运行 ssh-keygen -t rsa -C "你的GitHub邮箱"，然后连续按三次回车。
    • 添加密钥：复制生成的公钥文件 id_rsa.pub 的全部内容。进入 GitHub 的 Settings > SSH and GPG keys 页面，点击 New SSH key，将内容粘贴到 Key 框中。
    • 测试连接：运行 ssh -T git@github.com，如果看到包含你用户名的成功提示，即配置成功。

  3. 部署到 GitHub

    • 安装部署插件：在你的博客目录（my-blog）下运行：

      1
      npm install hexo-deployer-git --save

    • 修改配置文件：用文本编辑器打开博客根目录下的 _config.yml 文件，滚动到最底部，找到 deploy 部分，修改为如下格式（注意冒号后必须有一个空格）：

      1
      2
      3
      4
      deploy:
        type: git
        repo: git@github.com:你的用户名/你的用户名.github.io.git  # 这里使用SSH地址
        branch: main  # 或 master，根据你的仓库默认分支名而定

    • 生成并部署：在命令行中执行以下命令，即可完成部署。

      1
      2
      3
      hexo clean   # 清理缓存
      hexo generate  # 生成静态文件，可简写为 hexo g
      hexo deploy   # 部署到GitHub，可简写为 hexo d

      稍等片刻，你就可以通过 https://你的用户名.github.io 访问你的线上博客了！

部署过程中可能出现的报错问题

问题现象 原因分析 解决方案
Author identity unknown 和 unable to auto-detect email address 你的 Git 没有设置全局的用户名和邮箱，导致无法记录提交者信息。 在命令行中执行以下两条命令，将信息替换成你自己的（邮箱不一定是GitHub邮箱，可以是任意有效邮箱）： git config --global user.email "3518872137@qq.com" git config --global user.name "Sonh66"
LF will be replaced by CRLF 警告 这是由 Windows 和 Unix 系统文本文件换行符差异引起的，通常不影响部署，可以忽略或一劳永逸地解决。 执行以下命令禁用 Git 的自动换行符转换： git config --global core.autocrlf false
Error: Spawn failed 这通常是上述 Git 配置问题导致的部署进程失败。 在解决完前两个问题后，这个错误会自动消失。

🔧 详细解决步骤

请按照以下顺序操作：

1.

配置 Git 用户信息：这是解决当前问题的关键。

打开命令行（CMD 或 PowerShell），依次输入以下两条命令并执行：

1
2
git config --global user.email "3518872137@qq.com"
git config --global user.name "Sonh66"

2.

（可选）解决换行符警告：为了避免每次部署都看到大量警告，可以执行：

1
git config --global core.autocrlf false

3.

重新部署：完成上述配置后，回到你的 Hexo 博客目录（E:\Myblog\myblogs），再次执行部署命令：

1
hexo clean && hexo deploy

💡 预防与检查

-

验证配置：你可以通过运行 git config --global --list来检查刚才的全局配置是否已生效。

-

确保使用SSH：请再次确认你的 _config.yml文件中 deploy部分的 repo地址是 SSH 格式（git@github.com:Sonh66/Sonh66.github.io.git），而不是 HTTPS 格式，这能避免未来的认证问题。

附上：hexo三连payload：hexo clean && hexo g && hexo s