1. 事前准备

  • 必须：GitHub 账号
  • 推荐：Cloudflare 账号（用于加速）
  • 可选：自定义域名（或直接使用 GitHub.io / Pages.dev）

2. 软件安装

2.1 安装 Node.js

  1. 官网下载：https://nodejs.org/en
  2. 默认路径安装：C:/Program Files/nodejs/
  3. 验证安装：
    1
    node -v
  4. 配置国内镜像：
    1
    npm config set registry https://mirrors.huaweicloud.com/repository/npm/

2.2 安装 Git

  1. 官网下载：https://git-scm.com/downloads
  2. 默认路径安装：C:/Program Files/Git
  3. 安装后可使用：
    • Git CMD（Windows 命令风格）
    • Git Bash（Linux 命令风格，推荐）
    • Git GUI（图形界面，不推荐新手）

3. Git 与 GitHub 配置

3.1 配置用户名和邮箱

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

3.2 生成 SSH 密钥

1
ssh-keygen -t rsa -C "你的邮箱"
  • 一路回车即可，不建议设置密码
  • 生成文件位置：C:\用户\你的用户名\.ssh\
    • id_rsa：私钥
    • id_rsa.pub：公钥

3.3 添加公钥到 GitHub

  1. 复制 id_rsa.pub 文件内容
  2. GitHub → Settings → SSH and GPG keys → New SSH key
  3. 测试连接：
    1
    ssh -T git@github.com
    输入 yes，看到成功信息即配置完成

3.4 创建 GitHub Pages 仓库

  • 仓库名格式：<用户名>.github.io
  • 必须设为 Public
  • 初始化 README（可选）

4. Hexo 初始化

4.1 创建项目文件夹

1
2
mkdir D:\Hexo-Blog
cd D:\Hexo-Blog

4.2 安装 Hexo

1
npm install -g hexo-cli && hexo -v

4.3 初始化博客

1
2
3
hexo init blog-demo
cd blog-demo
npm i

4.4 目录结构

  • node_modules/：依赖包
  • scaffolds/：文章模板
  • source/：文章内容
  • themes/：主题
  • _config.yml：主配置文件
  • package.json：项目信息

4.5 本地预览

1
hexo cl && hexo s

访问：http://localhost:4000

5. 部署到 GitHub Pages

5.1 安装部署插件

1
npm install hexo-deployer-git --save

5.2 配置 _config.yml

1
2
3
4
deploy:
  type: git
  repository: git@github.com:你的用户名/你的用户名.github.io.git
  branch: main

5.3 部署命令

1
hexo clean && hexo generate && hexo deploy

或简写：

1
hexo cl && hexo g && hexo d

6. 部署到 Cloudflare Pages

  1. 登录 Cloudflare → Workers 和 Pages → Pages → 连接到 Git
  2. 选择 GitHub 并授权
  3. 选择博客仓库
  4. 保存并部署
  5. 部署成功后访问：https://你的项目.pages.dev
  6. 可绑定自定义域名

7. 日常使用

7.1 新建文章

1
hexo new "文章标题"

7.2 编辑文章

  • 编辑文件：source/_posts/文章标题.md
  • 使用 Markdown 格式

7.3 本地预览

1
hexo cl && hexo s

7.4 发布文章

1
hexo cl && hexo g && hexo d

8. 常见问题解决

8.1 发布文章

若出现 FATAL Port 4000 has been used. Try other port instead. 则在终端内输入查询4000端口占用情况

1
lsof -i :4000

比如进程 ID（PID）为 23188 就输入下面代码关闭该进程

1
kill -9 23188

VS Code 终端首次执行报错

以管理员身份运行 PowerShell：

1
Set-ExecutionPolicy RemoteSigned

9. 参考资料