部署到 GitHub Pages

四、部署到 GitHub Pages

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

1. 创建 GitHub 仓库:

   • 登录您的 GitHub 账号。
   • 创建一个新的公开仓库 (Public Repository)。
   • 仓库名称必须符合特定格式: 你的GitHub用户名.github.io。例如，如果您的 GitHub 用户名是 vmoranv，那么仓库名应该是 vmoranv.github.io。这是 GitHub Pages 的规定，用于生成您的博客主域名。

2. 安装 Hexo 部署插件: 在您的 Hexo 项目文件夹 (my-blog) 的终端中，安装 hexo-deployer-git 插件：

   1	npm install hexo-deployer-git --save

3. 配置站点部署信息: 打开 Hexo 项目根目录下的 _config.yml 文件 (注意不是主题的配置文件)，找到 deploy 部分，修改如下：

   1 2 3 4 5 6

   deploy: type: git repo: https://github.com/你的GitHub用户名/你的GitHub用户名.github.io.git # 将 "你的GitHub用户名" 替换为您的实际用户名 # 或者使用 SSH 地址 (推荐，如果已配置 SSH Key): # repo: git@github.com:你的GitHub用户名/你的GitHub用户名.github.io.git branch: main # 或者 master，取决于您 GitHub 仓库的默认分支名

   提示:

   • repo: 填写您上一步创建的 GitHub 仓库地址。
   • branch: 通常是 main 或 master。您可以在 GitHub 仓库页面查看您的默认分支名称。

4. 部署博客: 在 Hexo 项目文件夹中依次执行以下命令：

   1 2 3

   hexo clean # 清理缓存和已生成的静态文件 (可选，但推荐) hexo generate # 生成静态文件 hexo deploy # 部署到 GitHub Pages

   或者合并为一条命令：

   1	hexo clean && hexo g -d

   如果使用 HTTPS 地址部署，可能会提示输入 GitHub 用户名和密码（或 Personal Access Token）。如果使用 SSH 地址部署，并且已正确配置 SSH Key，则不会提示。
   如果部署成功，命令行会显示 Deploy done 或类似信息。

5. 访问您的博客: 稍等片刻（GitHub Pages 可能需要几分钟来构建和部署您的站点），然后访问您的 GitHub Pages 地址 https://你的GitHub用户名.github.io，您应该能看到部署成功的博客页面。