GitHub Pages部署

GitHub Pages 部署

GitHub Pages 是 GitHub 提供的免费静态网站托管服务，非常适合部署 Hexo 博客。

准备工作

1. 一个 GitHub 账号
2. 已安装 Git 并配置 SSH 密钥
3. 已创建好 Hexo 博客项目

创建仓库

1. 登录 GitHub
2. 点击右上角 + → New repository
3. 仓库名填写：username.github.io（将 username 替换为你的 GitHub 用户名）
4. 选择 Public
5. 点击 Create repository

安装部署插件

1

npm install hexo-deployer-git

配置部署

编辑 _config.yml，添加部署配置：

1
2
3
4
5

deploy:
  type: git
  repo: git@github.com:username/username.github.io.git
  branch: gh-pages
  message: "Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}"

将 username 替换为你的 GitHub 用户名。

部署

1
2
3
4
5
6
7
8

# 清除旧文件
hexo clean

# 生成静态文件
hexo generate

# 部署到 GitHub Pages
hexo deploy

或者一步到位：

1

hexo clean && hexo generate && hexo deploy

验证部署

部署完成后，访问 https://username.github.io 查看博客。

⚠️ 注意：首次部署可能需要等待几分钟才能生效。

自定义域名（可选）

如果你有自己的域名：

1. 在 source/ 目录下创建 CNAME 文件，内容为你的域名：

1

blog.example.com

2. 在域名 DNS 设置中添加 CNAME 记录：

1

blog.example.com → username.github.io

3. 在 GitHub 仓库 Settings → Pages 中勾选 Enforce HTTPS

常见问题

部署后页面 404

• 检查仓库名是否为 username.github.io
• 检查分支是否为 gh-pages
• 等待几分钟后刷新

样式丢失

检查 _config.yml 中的 url 和 root 配置：

1
2

url: https://username.github.io
root: /

权限问题

确保 GitHub 仓库 Settings → Actions → General 中：

• Workflow permissions 设置为 Read and write permissions

💡 提示：GitHub Pages 每月有 100GB 带宽限制，对于个人博客足够使用。