2025年，如何使用 github pages + Hexo + Next 搭建个人博客

引言
其实之前也一直有人问我hexo怎么搭建博客，只是我一直懒得回复。
自己搜一搜发现github做了很多更新，例如不支持ssh用户名密码更新，只支持ssh公钥。
因此很多资料都已经过时。2020年，使用 Hexo+GitHub 搭建个人免费博客教程（小白向）
2018年，GitHub + Hexo 从零开始搭建个人博客
本着为社区做贡献的精神，有了这篇文章。

正文

第一步，安装

1.1 安装hexo

在本地的电脑下载安装hexo。

🚀 Hexo 安装指南

Hexo 是一个基于 Node.js 的静态博客框架，需要 Node.js 和 Git 才能运行。下面是安装步骤：

🔹 1. 安装 Node.js 和 npm

Hexo 依赖 Node.js，所以你需要先安装 Node.js 和 npm（Node.js 的包管理工具）。

👉 在 Linux/macOS 安装 Node.js

  1. 使用 nvm 安装（推荐）：

    1
    2
    3
    curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
    source ~/.bashrc  # 或者 source ~/.zshrc
    nvm install --lts

    确保安装成功：

    1
    2
    node -v   # 查看 Node.js 版本
    npm -v    # 查看 npm 版本

  2. Ubuntu/Debian（如果不使用 nvm）

    1
    2
    sudo apt update
    sudo apt install nodejs npm -y

  3. CentOS

    1
    sudo yum install nodejs npm -y

👉 在 Windows 安装 Node.js

  1. 下载 Node.js 安装包：Node.js 官网
  2. 选择 LTS 版本 并安装（默认包含 npm）
  3. 验证安装：
    1
    2
    node -v
    npm -v

🔹 2. 安装 Git

如果 Git 还没安装，先安装 Git：

1
git --version  # 检查是否已安装 Git

如果没有安装，请参考：如何安装 Git。

🔹 3. 安装 Hexo

Node.js 和 Git 安装好后，使用 npm 安装 Hexo：

1
npm install -g hexo-cli

检查安装是否成功：

1
hexo -v

如果正确安装，你会看到：

1
2
hexo: 6.x.x
node: 18.x.x

🔹 4. 创建 Hexo 博客

1️⃣ 创建博客目录

1
2
3
4
5
hexo init my-blog  # my-blog 是博客目录名称
cd my-blog
git init     #初始化github的项目
npm install  # 安装 Hexo 依赖

2️⃣ 运行本地服务器

1
hexo server

然后在浏览器访问：
👉 http://localhost:4000/ （或你的服务器 IP）

🔹 5. 部署到 GitHub Pages

1️⃣ 配置 GitHub

编辑 _config.yml，找到 deploy 部分，修改为：

1
2
3
4
deploy:
  type: git
  repo: git@github.com:你的GitHub用户名/你的GitHub仓库.git
  branch: gh-pages

然后安装 Hexo 部署插件：

1
npm install hexo-deployer-git --save

2️⃣ 部署博客

1
2
3
hexo clean  # 清理缓存
hexo generate  # 生成静态文件
hexo deploy  # 部署到 GitHub

然后访问你的 GitHub Pages 地址：
👉 https://你的GitHub用户名.github.io/

🎯 总结

  1. 安装 Node.js 和 Git
  2. 安装 Hexo： npm install -g hexo-cli
  3. 创建博客： hexo init my-blog
  4. 本地运行： hexo server
  5. 部署到 GitHub Pages： hexo deploy

现在你已经成功安装 Hexo 并可以搭建自己的博客了！🎉🚀

1.2 安装git

如何安装 Git 🚀

Git 可以在 Windows、macOS 和 Linux 上安装。请根据你的系统选择对应的安装方法。

🔹 在 Linux 上安装 Git

如果你使用的是 Ubuntu、Debian、CentOS、Fedora 或其他 Linux 发行版，可以使用包管理器安装 Git。

1️⃣ Ubuntu / Debian

1
2
sudo apt update
sudo apt install git -y

2️⃣ CentOS / RHEL

1
sudo yum install git -y

3️⃣ Fedora

1
sudo dnf install git -y

4️⃣ Arch Linux

1
sudo pacman -S git

检查 Git 是否安装成功

1
git --version

如果显示 git version x.x.x，说明安装成功！🎉

🔹 在 macOS 上安装 Git

1️⃣ 使用 Homebrew（推荐）

如果你已经安装了 Homebrew，可以直接运行：

1
brew install git

2️⃣ 直接下载 Git 安装包

如果没有 Homebrew，你可以从官网下载安装：
👉 Git for macOS

检查 Git 是否安装成功

1
git --version

如果显示 git version x.x.x，说明安装成功！🎉

🔹 在 Windows 上安装 Git

1️⃣ 下载安装包

  • 访问 Git 官方网站：Git for Windows
  • 下载并安装 Git，使用默认选项（建议勾选 “Git Bash” 以便使用命令行）。

2️⃣ 检查 Git 是否安装成功

打开 命令提示符（cmd） 或 Git Bash，输入：

1
git --version

如果显示 git version x.x.x，说明安装成功！🎉

🔹 额外配置（可选）

安装 Git 后，你可以配置 Git 的用户名和邮箱：

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

然后查看是否配置成功：

1
git config --list

🎯 总结

  • Linux：使用 apt、yum、dnf 或 pacman 安装
  • macOS：使用 brew install git 或下载官方安装包
  • Windows：下载官方 .exe 安装包

现在你可以开始使用 Git 了！🎉 🚀

第二步，创建

2.1 创建账号

建立github账号，建立仓库

仓库名词要是[用户名].github.io

2.2 创建main

https://github.com/feminism-cn/feminism-cn.github.io/settings/pages

2.2 创建ssh密钥

① 生成 SSH 密钥

1
ssh-keygen -t rsa -b 4096 -C "【你的邮箱地址】@example.com"

然后一路回车，默认存放在 ~/.ssh/id_rsa。

② 添加 SSH 密钥到 GitHub

运行：

1
cat ~/.ssh/id_rsa.pub

复制输出的内容，进入 GitHub SSH 密钥管理页面 ，添加新的 SSH Key。

③ 测试 SSH 连接

1
ssh -T git@github.com

如果成功，会显示：

1
Hi 【你的用户名】! You've successfully authenticated, but GitHub does not provide shell access.

④ 添加 Git 远程地址

1
git remote add origin origin git@github.com:【你的用户名，记得修改】/【你的用户名，记得修改】.github.io.git

⑤ 重新推送代码

1
git push -u origin main

3. 确保 Git 版本是最新

运行：

1
git --version

如果 Git 版本较旧，建议升级：

1
2
apt update && apt install git -y  # Ubuntu/Debian
yum install git -y  # CentOS

2.3 创建博客

你需要在本地新建一个文件夹，存放你的博客文章

假如你的文件夹目录名词为test,那么命令如下

hexo init test
cd test

第三步，修改

3.1 修改config

在test目录下，有个文件叫做_config.yml
打开它，翻到最下方

1
2
3
4
deploy:
  type: 'git'
  repo: git@github.com:【你的用户名，记得修改】/【你的用户名，记得修改】.github.io.git
  branch: main

3.2 修改博客内容

把你要写的内容放在 /root/blog/source/_posts/
这个目录下

等内容更新好，先在内网看一眼效果。

使用命令hexo s， 此时默认开放在4000端口。
如果该端口被占用，可以用 hexo s -p 8045，这样可以指定8045端口

第四步，推送

Hexo g 和 Hexo d 命令详解 🚀

Hexo 提供了一些常用命令来管理博客，其中 hexo g 和 hexo d 是两个核心命令：

🔹 1. hexo g（hexo generate）—— 生成静态文件

1
hexo g

完整写法：

1
hexo generate

作用：

  • 将 source/ 目录下的 Markdown 文件转换为 HTML 静态文件，并存放到 public/ 目录。
  • 生成的文件可以直接上传到服务器或 GitHub Pages。

常见问题：

  • 运行 hexo g 后，如果 public/ 目录没有变化，说明可能有缓存问题，可以先运行：
    1
    hexo clean && hexo g
    hexo clean 会清理 Hexo 缓存并重新生成静态文件。

🔹 2. hexo d（hexo deploy）—— 部署到 GitHub Pages

1
hexo d

完整写法：

1
hexo deploy

作用：

  • 将 public/ 目录的内容推送到远程 Git 仓库（例如 GitHub Pages）。
  • 需要在 _config.yml 里配置 deploy 选项（通常推送到 gh-pages 分支）。

常见问题：

  • hexo d 之前必须先运行 hexo g，否则不会生成最新的页面内容。
  • 如果 hexo d 失败，可能需要重新安装部署插件：
    1
    npm install hexo-deployer-git --save
  • 确保 _config.yml 里的 deploy 配置正确：
    1
    2
    3
    4
    deploy:
      type: git
      repo: git@github.com:你的GitHub用户名/你的GitHub仓库.git
      branch: gh-pages  # 或者 main，看你的 GitHub Pages 配置

🔹 3. hexo g -d（生成并部署）

1
hexo g -d

作用：

  • hexo g 生成静态文件
  • hexo d 部署到 GitHub

等价于：

1
hexo generate && hexo deploy

适合一键更新博客内容。

🔹 4. 推荐的 Hexo 部署流程

每次写完文章后，建议按照以下步骤部署：

1
2
3
hexo clean   # 清理缓存（可选）
hexo g       # 生成静态文件
hexo d       # 部署到 GitHub

🎯 总结

命令 作用
hexo g 生成静态文件（Markdown → HTML）
hexo d 部署到 GitHub Pages
hexo g -d 生成并部署
hexo clean 清理缓存

试试看 hexo g -d，然后访问你的博客，看看是否更新成功！🚀🎉

最后，github 的效果应该是和内网访问的保持一致。

访问https://【你的用户名，记得修改】.github.io

就可以看到你的博客公开在互联网上了。

需要注意的是，你千万不要自己去买一些稀奇古怪的域名，用github.io就挺好。
你坚持不了几年的。如果你能坚持写博客3年以上，再去考虑用个人域名。

大部分人搞的博客+域名，没几年再去打开，就发现变成博彩站或者其他东西了。 坚持是很难的。