Hexo + GitHub 搭建个人博客

前言

本文记录使用 Hexo + GitHub Pages 从零搭建个人博客的完整流程，分为四步：本地环境准备 → 连接 GitHub 仓库 → 本地生成博客 → 部署上线。

一、本地环境准备

1. 安装 Node.js

前往官网下载：<https://nodejs.org/zh-cn>

2. 安装 Git

前往官网下载：<https://git-scm.com/downloads>

安装完成后，以管理员身份运行 cmd，输入以下命令验证是否成功：

node -v
npm -v
git -v

3. 安装 Hexo

npm install hexo-cli -g

二、连接 GitHub 仓库

1. 创建仓库

在 GitHub 上新建仓库，注意以下几点：

• 仓库名必须为 用户名.github.io（例如 76-s.github.io）
• 勾选 Public
• 勾选 Add a README file
• 点击 Create repository 完成创建

2. 配置 SSH Keys

在任意文件夹空白处右键，选择 Git Bash Here，输入：

ssh-keygen -t rsa -C "你的邮箱地址"

连按 4 次 Enter 使用默认配置即可。然后：

1. 进入 C:\Users\用户名\.ssh 目录
2. 用记事本打开 id_rsa.pub，全选并复制其中的内容
3. 打开 GitHub → Settings → SSH and GPG keys → New SSH key
4. 名称随意填写，将复制的内容粘贴到 Key 一栏，保存

在 Git Bash 中测试连接是否成功：

ssh -T git@github.com

首次连接会提示确认，输入 yes 回车。看到 Hi 用户名! You've successfully authenticated 即表示配置成功。

三、本地生成博客

在喜欢的位置新建博客文件夹（如 Blog），进入该文件夹，右键打开终端或 Git Bash，执行：

hexo init

如果提示 command not found，在命令前加上 npx，即 npx hexo init。

初始化完成后，依次执行：

hexo g    # 生成静态页面
hexo s    # 启动本地预览

终端会输出预览地址（默认为 http://localhost:4000），复制到浏览器即可预览博客。

国内访问 GitHub 可能不稳定，若安装依赖失败，可以稍后重试或配置代理/镜像源。

预览确认无误后，回到命令行按 Ctrl + C 关闭预览。

四、部署上线

1. 修改站点配置

打开博客文件夹根目录下的 _config.yml，找到 url 字段并修改为你的仓库地址：

# URL
## Set your site url here. For example, if you use GitHub Page, set url as 'https://username.github.io/project'
url: https://76-s.github.io

2. 配置部署信息

先在 GitHub 仓库页面点击 Code，复制 SSH 地址（形如 git@github.com:76-s/76-s.github.io.git）。

然后在 _config.yml 最底部找到 deploy 部分，将原有内容注释掉，替换为：

deploy:
  type: git
  repo: git@github.com:76-s/76-s.github.io.git
  branch: main
  message: "V1.0.0"

注意 YAML 格式：

• deploy 顶格写，其下的子项统一缩进两个空格
• 每个冒号后面必须有一个空格
• repo 后面粘贴仓库的 SSH 地址

修改完成后保存退出。

3. 安装部署插件并上传

在博客文件夹中打开终端，先安装 Git 部署插件：

npm install hexo-deployer-git --save

然后依次执行：

hexo g    # 生成
hexo d    # 部署上传

首次使用 Git 需要先配置用户信息：

git config --global user.email "你的邮箱"
git config --global user.name "你的名字"

配置完成后重新执行 hexo d，并在弹出的窗口中完成 GitHub 登录授权。

4. 完成

上传成功后，访问 https://用户名.github.io 即可看到你的博客。至此，Hexo + GitHub Pages 个人博客搭建完成 🎉