为了照顾小白用户（第一次使用 GitHub 和 Hexo），尽可能详细，包括常见的坑和问题都有提示说明。下面目录中第 3~5 步为最重要的步骤，其他内容如果已经会的可以选择性跳过。

看起来有点繁杂，捋顺了倒也简单，认真跟教程走，完整操作一遍大概需要 30 分钟。o(￣▽￣)ｄ

内容目录：

• 简介：GitHub Pages 和 Hexo & 原理

1. 准备：环境搭建
   1. 注意事项
   2. 环境搭建
2. 连接 Github
3. 创建 Github Pages 仓库
4. 本地安装 Hexo 博客程序
   1. 安装 Hexo
   2. Hexo 初始化和本地预览
5. 部署 Hexo 到 GitHub Pages
6. 绑定域名（可选）
7. 开始使用
   1. 发布文章
   2. 网站设置
   3. 更换主题
   4. 常用代码
8. 常见问题

简介

GitHub Pages 是什么？

• What is GitHub Pages? – GitHub Help

GitHub Pages 是由 GitHub 官方提供的一种免费的静态站点托管服务，让我们可以在 GitHub 仓库里托管和发布自己的静态网站页面。

由于网站内容是公开在网络上的，因此注意不要发布隐私和敏感内容。当然也存在一定的使用限制：网站不超过 1 GB，月流量 100 GB 以内。

Hexo 是什么？

• 官网：hexo.io

Hexo 是一个快速、简洁且高效的静态博客框架，它基于 Node.js 运行，可以将我们撰写的 Markdown 文档解析渲染成静态的 HTML 网页。

Hexo + GitHub 文章发布原理

在本地撰写 Markdown 格式文章后，通过 Hexo 解析文档，渲染生成具有主题样式的 HTML 静态网页，再推送到 GitHub 上完成博文的发布。

优点和不足

优点：完全免费；静态站点，轻量快速；可按需求自由定制改造；托管在 GitHub，安全省心；迁移方便……

不足：发文不便，依赖于本地环境；更适合个人博客使用；GitHub 在国内访问速度有点不快。

1. 准备

注意事项

• 输入代码时，核对准确，最好切换成英文输入法；
• 将文中的 “用户名” 和 “邮箱” 替换为自己的 GitHub 账户名和绑定的邮箱；
• 统一使用 Git Bash 进行操作（支持 Win、Mac、Linux）；
• # 后面为注释，复制代码时不要复制；
• 每次修改后都需要运行 hexo g 和 hexo d 使其生效；
• 小白请严格按步骤进行，不要跳！

环境搭建

Hexo 基于 Node.js，搭建过程中还需要使用 npm 和 git，因此先搭建本地操作环境，安装 Node.js 和 Git。

• Node.js：https://nodejs.org/zh-cn
• Git：https://git-scm.com/downloads
• 网盘下载：Node.js，Git（点 “普通下载”）

下载 Node.js 和 Git 程序并安装。Node.js 默认安装 npm，一路点 “下一步” 按默认配置完成安装。

安装完成后，Win+R 输入 cmd 并打开，依次输入 node -v、npm -v 和 git --version 并回车，如下图出现程序版本号即可。

2. 连接 Github

使用邮箱注册 GitHub 账户，选择免费账户（Free），并完成邮件验证。

右键 -> Git Bash Here，设置用户名和邮箱：

创建 SSH 密匙，输入 ssh-keygen -t rsa -C "GitHub 邮箱"，然后一路回车。密匙生成位置在 C:\Users\用户名.ssh 目录下（要勾选显示“隐藏的项目”选项）。

登陆 GitHub ，进入 Settings 页面，选择左边栏的 SSH and GPG keys，点击 New SSH key，添加密匙：

Title 随便取个名字，用记事本打开公钥 id_rsa.pub 复制里面的内容，粘贴到 Key 中，点击 Add SSH key 完成添加。

验证连接：打开 Git Bash，输入 ssh -T [email protected] 出现 “Are you sure……”，输入 yes 回车确认。

显示 “Hi xxx! You’ve successfully authenticated……” 即连接成功。

3. 创建 Github Pages 仓库

GitHub 主页右上角加号 -> New repository。

Repository name 中输入 用户名.github.io，勾选 “Initialize this repository with a README”，Description 选填。填好后点击 Create repository 创建。

创建后默认自动启用 HTTPS，博客地址为：https://用户名.github.io

4. 本地安装 Hexo 博客程序

新建一个文件夹用来存放 Hexo 的程序文件，如 Hexo-Blog。打开该文件夹，右键 -> Git Bash Here。

4.1 安装 Hexo

使用 npm 一键安装 Hexo 博客程序：

Mac 用户需要管理员权限（sudo），运行这条命令：

安装时间有点久（真的很慢！），界面也没任何反应，耐心等待，安装完成后如下图。

4.2 Hexo 初始化和本地预览

输入 hexo init 进行初始化，显示 “Start blogging with Hexo!”，然后运行 npm install 安装所需组件。

完成后依次输入下面命令，启动本地服务器进行预览：

访问 http://localhost:4000，出现 Hexo 默认页面，本地博客安装成功！

Tips：如果出现页面加载不出来，可能是端口被占用了。Ctrl+C 关闭服务器，运行 hexo server -p 5000 更改端口号后重试。

Hexo 博客文件夹目录结构如下：

5. 部署 Hexo 到 GitHub Pages

本地博客测试成功后，就是上传到 GitHub 进行部署，使其能够在网络上访问。

首先安装 hexo-deployer-git：

然后修改 _config.yml 文件末尾的 Deployment 部分，修改成如下：

完成后运行 hexo d 将网站上传部署到 GitHub Pages。完成！这时访问我们的 GitHub 域名 https://用户名.github.io 就可以看到 Hexo 网站了。

6. 绑定域名（可选）

博客搭建完成使用的是 GitHub 的子域名（用户名.github.io），我们可以为 Hexo 博客绑定自己的域名替换 GitHub 域名，更加个性化和专业，也利于 SEO。

我们使用 Namesilo 进行注册，便宜好用没啥套路，使用优惠码 okoff 优惠一美元，com 域名优惠时大概 40 多块一年。

6.1 域名注册和解析

• 域名注册和解析教程：Namesilo 域名购买及使用教程

按上面教程注册并解析域名，在 DNS 设置部分，删除自带的记录，然后添加 CNAME 记录将 www 域名解析指向 用户名.github.io。

6.2 绑定域名到 Hexo 博客

进入本地博客文件夹的 source 目录，打开记事本，里面输入自己的域名，如 www.example.com，保存名称为 “CNAME”，格式为 “所有文件”（无 .txt 后缀）。

清除缓存等文件并重新发布网站：

现在就可以使用自己的域名访问 Hexo 博客了。

6.3 开启 HTTPS

配置自己的域名后，需要我们手动开启 HTTPS。打开博客所在 GitHub 仓库，Settings -> 下拉找到 GitHub Pages -> 勾选 Enforce HTTPS。

HTTPS 证书部署成功需要一定时间，等大概几分钟再访问域名，就可以看到域名前面的小绿锁了，HTTPS 配置完成！

7. 开始使用

7.1 发布文章

进入博客所在目录，右键打开 Git Bash Here，创建博文：

然后 source 文件夹中会出现一个 My New Post.md 文件，就可以使用 Markdown 编辑器在该文件中撰写文章了。

写完后运行下面代码将文章渲染并部署到 GitHub Pages 上完成发布。以后每次发布文章都是这两条命令。