这可能是迄今为止最全的hexo博客搭建教程

点击上方“Python数据科学”，星标公众号

重磅干货，第一时间送达

500g+超全学习资源免费领取，干货来袭！

转自：程序员小明

背景

喜欢写 Blog 的人，会经历三个阶段。

第一阶段，刚接触 Blog，觉得很新鲜，试着选择一个免费空间来写。

第二阶段，发现免费空间限制太多，就自己购买域名和空间，搭建独立博客。

第三阶段，觉得独立博客的管理太麻烦，最好在保留控制权的前提下，让别人来管，自己只负责写文章。

这是阮一峰在博客中写到的关于 Blog 的想法，而这里的第三阶段的实现就是利用 GitHub Pages 搭建博客。

使用 GitHub Pages 功能搭建博客的好处有：

免费，GitHub 提供无限流量。

都是静态文件，世界各地都有理想的访问速度。(访问速度可以进一步优化)

拥有绝对的管理权，又享受 Git 的版本管理功能，不用担心文章遗失。

Hexo 是基于 Node.js 的一款静态博客框架，如果想要搭建博客，不想自己写页面的话可以考虑用 Hexo，其中有很多的简洁主题可供选择，同时 Hexo 支持 Markdown 语法，编辑文章更加方便，快捷。

注：此篇分享还以 Mac 为例哈

环境配置

Hexo 文档有对 Hexo 安装及使用的详细介绍，推荐阅读。这里我主要写自己安装的步骤、踩过的坑以及一些优化的方法。

在正式安装 Hexo 之前，我们需要确认电脑中是否已安装下列应用程序:

Node.js

Git

当然，我们还需要 GitHub 账号，如果没有请注册。

注册之后记得一定要前往邮箱确认注册，否则无法使用 GitHub Pages。

安装 Hexo

所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。终端输入如下命令:

输入管理员密码( Mac 登录密码)即开始安装。

这里有个小坑：Hexo 官网上的安装命令是，安装时不要忘记前面加上，否则会因为权限问题报错。

初始化

使用终端到一个您指定的目录，执行以下命令(命令中的是您将要建立的文件夹的名称)：

使用终端到文件夹下，执行以下命令，安装npm：

好了，现在可以试试看是否已经初始化成功，执行如下命令，开启本地 Hexo 服务器：

此时，浏览器中打开网址(默认是4000端口) http://localhost:4000 ，能看到如下页面：

Hexo 本地

这里我踩了个不算坑的坑，终端输入后没有成功，我也在网上搜到了很多解决办法，但是都没有奏效，后来我尝试改了下端口就成功了，也就是说默认的4000端口无法连接。如果您的情况跟我一样，尝试了网上的很多解决办法之后依然无效，那您也许可以尝试输入命令改一下端口试试看。

关联 GitHub

创建仓库

登录您的 GitHub 账号，新建名称为的仓库。假设我的 GitHub 账号的用户名是 ，那么我就应该新建名称为的仓库。

可写可不写，随意。

勾上。

点击完成创建。

开启 GitHub Pages

点击，你将会打开这个库的 Settings 页面，向下拖动，直到看见 GitHub Pages，如图：

gh-p修改全局配置文件

Hexo 官方文档中有对全局配置的详细说明，推荐阅读。

小坑提醒，修改本地所有的配置文件时，注意所有的冒号后边都要加一个空格，否则执行 Hexo 命令时会报错，一定注意。

找到本地文件夹下，打开后滑到最后，修改成下边的样子：

您需要将后的所有换成你自己的用户名，或者也可以在下图位置获取：

https 地址

然后，您需要为自己配置身份信息，终端输入和换成您自己的 GitHub 用户名和邮箱)：

终端到文件夹下执行生成静态页面命令：

此时若出现如下报错：

尝试执行命令：

若无报错，自行忽略此步骤。

然后在当前目录下，终端输入：

这里踩了个坑，如果您执行命令仍然报错：无法连接 git 或找不到 git，则执行如下命令来安装：

完成安装之后，再次执行和命令。

随后按照提示，分别输入自己的 GitHub 用户名和密码，开始上传。

完成上传之后，通过 (换成您自己的仓库名，也就是用户名)来访问自己刚刚上传的网站。

为避免每次输入 GitHub 用户名和密码的麻烦，可参照后文优化(个性化设置)进行优化

常用指令和发布文章

常用指令

常用组合

发布文章

终端到文件夹下，执行如下命令新建文章：

名为的文件会建在目录下。

所有的文章都会以形式保存在文件夹中，只要在文件夹中新建类型的文档，就能在执行的时候被渲染。新建的文章头需要添加一些信息，如下所示：

文章编辑完成后，终端到文件夹下，依次执行如下命令来发布：

至此，Mac 上搭建基于 GitHub Pages + Hexo 的博客就完成了。

下面的内容是介绍安装 Themes 、个性化设置以及优化。

设置 Themes

如果您喜欢 Hexo 默认的主题的话，可以跳过这部分。如果您想换一个主题的话，可以到Hexo 主题挑选自己中意的主题。

这里以nexT 主题为例。

终端到目录下执行如下命令(这是目前的稳定版本，不是最新版。最新版有一些新特性，但是可能会不稳定，所以这里推荐选择安装稳定版)：

如果想尝试最新版，请执行如下命令：

打开目录下的，找到修改为。

终端到目录下，依次执行如下命令(每次部署文章的步骤)：

至于更改博客的名称、描述、头像等，只需要修改文件和文件中对应的属性名称即可(不要忘记冒号后加空格)。