【效率为王】超详细 Hexo + Github Pages 博客搭建教程

前言

现在市面上已经有许多博客了，比如 CSDN、掘金、博客园、简书等等。我们可以直接在上面发表内容，而且交互比较人性化，而且也能被搜索引擎检索到。但是总归是别人的平台，经常会受限，因此我们就希望能有自己的博客。之前也尝试过搭建过不同的博客类型，折腾了不少工作，最终决定定型，采用 Hexo + Github Pages 的方式。今天就带大家一起来搭建自己的博客。由于是采用 Hexo + Github Pages 的方式，所以都是免费的，只是需要有一定的动手能力！

Hexo 简介

Hexo[1] 是一个快速、简洁且高效的静态博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。我们只需要通过 Markdown 语法写好自己的博客内容，然后通过简单的命令就能够将生成的网页上传到 Github，然后大家都可以来访问你的网页了。既方便了自己，也给了自己一个展示自己成果的平台，是不是一举两得。

搭建步骤

搭建之前，需要做一些准备工作，首先需要确保你的电脑上已经上安装好了 Git 和 Node.Js，然后才能开始安装 Hexo，那么首先我们先来看看如何准备这这些环境。

Git

安装

1. Window：下载并安装[2]
2. macOS：下载并安装[3]
3. Linux（Debian，Ubuntu）：sudo apt-get install git-core
4. Linux（Fedora、RedHat、CentOS）：sudo yum install git-core

设置

安装成功后，将 git 与 GitHub 账号绑定，右键打开 Git Bash，然后设置配置信息：

# 配置用户名和邮箱
git config --global user.name "github 用户名"
git config --global user.email "github 注册邮箱"

比如我的配置就是：

git config --global user.name "cunyu1943"
git config --global user.email "747731461@qq.com"

接着生成 ssh 密钥文件，输入如下命令后直接三次回车即可，一般不需要设置密码；

# 生成 ssh 密钥
ssh-keygen -t rsa -C "github 注册邮箱"

我生成秘钥的命令：

ssh-keygen -t rsa -C "747731461@qq.com"

一般执行上述命令之后，会生成 id_rsa 和 id_rsa.pub 两个文件，前者是我们私有的，而后者则是对外开放的。接着找到生成的 .ssh 的文件夹中的 id_rsa.pub 密钥，将内容复制；

然后打开 GitHub-Settings-Keys[4] 页面，创建一个新的 SSH key，填写 Title 和 Key，Title 可以随意，而 Key 的内容则是我们刚才复制的 id_rsa.pub 中的内容，最后点击 Add SSH key 即可；

Node.Js 安装

安装

去官网下载最新的稳定版 Node.JS[5] ，一般推荐 64 位（大家应该现在用的电脑基本都是 64 位的吧），安装的话很简单，基本就是下一步下一步点击就好了。如果还是不知道如何安装，可以参考我的另一篇博客：Windows 下 Node.js 的安装（多图版）[6]

验证

安装完成后，要查看我们是否安装成功，可以打开命令提示符（Win + R），输入 cmd 打开控制台，输入如下命令，如果出现对应版本号，说明安装成功了；

node -v
npm -v

设置

由于下载包是从国外服务器，所以速度较慢，因此我们推荐用阿里的国内镜像进行设置；

npm config set registry https://registry.npm.taobao.org

Hexo 安装

在你的硬盘上找个地儿，用来存放你的博客文件，比如我的就在 D:personalFiles/github/blog，这个文件夹你可以根据自己的喜好来设置。然后从命令台进入当前文件夹，接下来就是安装过程了；

1. 首先安装 Hexo

npm i hexo-cli -g

1. 新建一个文件夹用于存放你的博客，比如我的是 blog，然后进入该文件夹，并用如下命令进行初始化并安装必备组件；

hexo init .
npm install

1. 初始化后，目录结构如下；

.
├── _config.yml # 网站配置信息
├── package.json # 应用程序信息
├── scaffolds # 模板文件夹
├── source # 存放用户资源
|   ├── _drafts
|   └── _posts
└── themes # 主题文件夹

1. 然后输入如下命令，然后在浏览器中打开 http://localhost:4000；

# 新建博客
hexo new "博客名"
# 生成静态网页
hexo g
# 打开本地服务器
hexo s

然后就可以看到如下的界面，不过我的是经过修改过的，所以和你的会不一样。

Github 个人仓库

完成上面的步骤之后，我们就能在本地进行预览了，不过我们如果想要发布到网上供别人看的话，那就得利用 Github Pages 的功能了，下边就来介绍如何结合 Hexo + Github Pages ，将我们的博客推送到网上去，方便大家在任何地方访问！

首先你得有个 GitHub 账号，如果没有的，请出门 右转[7] 先去注册个账号；

有了账号之后，新建一个仓库，而且得确保你的仓库是 public，你要搞个 private，谁能访问的了？？？同时，仓库名一定要是：

用户名.github.io 用户名.github.io 用户名.github.io

这个用户名建议不要太复杂，但是又要能体现你个人特点，因为后续让别人访问你的博客时，就要通过 https://用户名.github.io 这个域名来访问。比如我的用户名是 cunyu1943，所以我的仓库就是 cunyu1943.github.io[8]：

部署到 Github

完成上面的步骤后，你应该能在本地进行预览了，接下来就是推送网站到 Github Pages 了，然后我们就能被其他人访问了。

只需要在我们刚才的博客根目录中的站点配置文件 _config.yml ，设置为你的个人仓库名即可：

完成上述步骤之后，主要使用如下命令，就能将我们本地的内容推送到远程 GitHub 仓库了，然后在浏览器中访问：

https://用户名.github.io

比如我的博客 村雨遥的博客[9]；

hexo clean
hexo g
hexo d

Gitee 个人仓库

上面说完部署到 Github，接下来就说说怎么部署到 Gitee，老规矩，首先你得需要一个 Gitee 账号，如果没有的，出门 右转[10] 先去注册个账号。

然后新建一个仓库，同样有几点需要注意的：

1. 保证你的仓库是 public；
2. 仓库名是 你的用户名，这一点和 Github 略有不同，不需要是 用户名.gitee.io；

比如我的用户名是 cunyu1943，所以我的仓库名就是 cunyu1943[11]。

部署到 Gitee

完成上面的步骤后，你应该能在本地进行预览了，接下来就是推送网站到 Gitee Pages 了，然后我们就能被其他人访问了。这里需要注意的是，Gitee Pages 不像 Github Pages 会自动更新，它需要你每次推送后，去更新一下，如果想要自动更新，就需要开通 Gitee 的会员。

然后需要在我们刚才的博客根目录中的站点配置文件 _config.yml ，设置为你的个人仓库名即可：

完成上述步骤之后，主要使用如下命令，就能将我们本地的内容推送到远程 Gitee 仓库了，去手动更新 Gitee Pages 后，然后在浏览器中访问：

https://用户名.gitee.io

如何写新博客并推送到远程

通过上面的步骤后，你的博客应该就已经搭建成功，而且能通过 https://用户名.github.io 的方式进行访问了。接下来如果我们要发一篇新的博客内容，又应该怎么办呢？接下来就详细讲一下如何操作。

1. 首先进入博客所在文件夹，然后右键进入控制台，用如下命令进行创建新的文章；

hexo n "博客标题名"

1. 接着在 blog/source/_posts 目录下应该就会有创建好的以文章标题名命名的 Markdown 文件；

1. 接着打开该文件，编写你自己想要的内容即可；

1. 接着在控制台使用如下命令，将其推送到远程 GitHub 仓库，等过一会儿之后，访问即可看到刚才推送的新文章了！

hexo g
hexo d

如何绑定自定义域名

通过 用户名.github.io 的方式来访问总归是有些不方便，如果我们需要自己的个性域名，又应该如何设置呢？那么在此之前，你需要有一个已经备案好的域名，如果没有的话，请到阿里云、腾讯云等商购买自己的域名，然后通过该平台备案，然后添加两条解析记录，以我的腾讯云为例：

备好案并设置解析之后，在 Github 的博客项目中，依次点击 Settings->Pages，然后在 Custom domain 添加你的域名即可，最后 Save 即可，此时你的博客根目录下应该会多一个 CNAME 的文件，然后你就可以通过自己的域名来访问你的博客了。

当然，有时候可能经过上面的设置后，博客根目录下不会出现名为 CNAME 的文件，如果没有，我们可以通过在本地博客 /source 目录下手动建立一个 CNAME 文件（无后缀），然后把你的域名填进去并保存，最后依次执行如下命令将设置上传到 Github 即可 ~

hexo g
hexo d

比如我的域名为 cunyu1943.site，通过设置之后，我们就可以通过 https://cunyu1943.site 来访问我的博客了。

美化

经过上面的设置之后，我们只是得到了一个简单的博客，如果你也想让你的博客像我的一样酷（zhuang）炫（bi），就要用到主题了，我采用的主题是 hexo-theme-matery[12]，一个基于材料设计和响应式设计而成的主题，而且关于如何设置它也有十分详细的文档，如果存在不懂得问题，还可以及时提交 issue，作者回复也十分及时。

如果你不想过于折腾，那么你完成上面的步骤之后，也可以直接采用我的博客源代码，然后把里边的个人配置改一下就 ok 了，我的博客源码地址：cunyu1943/hexo-theme-matery-personal[13]

大家直接下载下来，然后把 node_modules.zip 进行解压，然后修改其中的部分配置（也就是你的 Github、网名啥的呀个人信息），主要是修改根目录下的 _config.yml 和 _config.hexo-theme-matery.yml，然后就可以直接写博客了。当然，前提是你把环境啥的都搭建好了。

PS：我对于配置文件中的某些关键信息进行了隐藏，比如 gitalk、gitment、Valine、baiduAnalytics 等，这些需要你自己去注册并获取自己的信息，请记得修改，否则可能导致失败。

总结

至此，我们的博客就搭建完成了，是不是很简单，赶紧去试试吧！

对于文中不清楚的地方，欢迎留言，我会在看到的第一时间回复你！

参考资料

[1]

Hexo: https://hexo.io/zh-cn/docs/

[2]

Windows安装Git: https://git-scm.com/download/win

[3]

macOS安装Git: https://sourceforge.net/projects/git-osx-installer/

[4]

GitHub-Settings-Keys: https://github.com/settings/keys

[5]

Node.JS: https://nodejs.org/en/

[6]

Windows 下 Node.js 的安装（多图版）: https://blog.csdn.net/github_39655029/article/details/105397485

[7]

Github: https://github.com/

[8]

cunyu1943.github.io: https://github.com/cunyu1943/cunyu1943.github.io

[9]

村雨遥的博客: https://cunyu1943.github.io/

[10]

Gitee: https://gitee.com/

[11]

cunyu1943: https://gitee.com/cunyu1943/cunyu1943

[12]

hexo-theme-matery: https://github.com/blinkfox/hexo-theme-matery

[13]

cunyu1943/hexo-theme-matery-personal: https://github.com/cunyu1943/hexo-theme-matery-personal