大家好，我叫苏日俪格，在网上看了好多5分钟/10分钟教你搭建博客，然而没想到的是前方一大堆坑等着你跳，相信许多人也都准备搭建一个属于自己的博客，当然这里已经说了是基于Hexo的，而且一切都是托管在GitHub上的，然后再使用 GitHub Pages 建立博客，下面开始吧：

本文所有参考文档均放在文章底部

一、Hexo是什么？

Hexo官网点这里

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

其实说白了就是将我们所熟悉的写博客文件的格式.md解析成了html，服务数据什么的官方已经帮助解决，我们再将其托管在GitHub Pages上，这样就可以实现完全免费构建博客，当然推荐爬梯，否则会很慢

二、安装

安装之前电脑中需要有 nodeJs 和 git ，接下来Git Bash Here：

$ npm install -g hexo-cli

接下来建站需要自己的GitHub Pages，没有的可以参考我的博客—关于GitHub

三、建站

1. 初始化

hexo脚手架安装完之后，需要初始化一个博客的目录(ps:初始化目录可以自行创建也可以以下面这种方式创建)：

$ hexo init <folder>

小坑：<>这个符号只是为了标明可自行更改，并不是一个格式；exp：hexo init blog

2. 安装依赖包

进入刚刚初始化目录，安装…

$ cd <folder>
$ npm install

安装完成之后目录结构是这样的：

.
├── _config.yml                // 整个网站信息的配置文件
├── package.json               // 依赖包文件的配置
├── scaffolds                  // 新建文章时通过它建立文件
├── source                     // 原文件目录
|   ├── _drafts
|   └── _posts
└── themes                     // 主题目录

有的人安装完之后没有_drafts，没关系的，没有会把我们的所有源文件解析放在 public 文件夹下

3. 启动服务

$ hexo server 或者 $ hexo s

看到INFO Start processing INFO Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.即为成功，直接访问即可：

如果嫌每次都得执行那几步更新操作麻烦,可以通过hexo-browsersync插件达到自动刷新状态,直接运行服务即可,下面是安装方法,安装之后无需其他操作:

$ npm install hexo-browsersync --save

四、配置

虽然能用了，但这都是官网默认的东西，需要通过文件 _config.yml 改成自己的：

• 这里有很多项，具体都是干什么的可以参照网站配置项；
• 每一项的键值对都必须以空格隔开，exp：key: value；
• 这里的语言类型大可不必写，因为都是官方的标准写法，自己写容易出错，还有就是timezone，默认参照的是我们使用的电脑的时区，强迫症可具体查看时区列表。

如果这里没有采用官方写法就会跳进坑里，后期提交新的文章会报错：TypeError: Cannot read property 'utcOffset' of null

下面是我的配置：

theme 是我自己下载的主题，更多主题在这里

deploy 这个配置项是将我们的文件托管，请看第五步☟：

五、创建一个新的仓库

在GitHub Desktop或者GitHub官网上创建一个名字为：<你的GitHub账户名>.github.io的仓库；
下面这个是我的：

六、发表文章

此过程依次参照下面几步：

$ hexo new <title>      // title 就是要发表的文章名
$ hexo generate 或者 $ hexo g        // 生成静态文件
$ hexo server          // 启动服务

在写文章的时候如果不会写markdown文件的时候可以参考我的博客：markdown编写

如果不想在简书上编写的话，可以用编写markdown文件的编辑器，下载地址：http://markdownpad.com/download.html

在我把简书上的文章复制过去的时候，又遇到了一个小坑，h1~h6标题必须在#后面加个空格，否则不生效

之后若在想修改博客里面的内容的时候，就一定要先清缓存，否则改了之后访问有的时候不会变

$ hexo clean        // 清除缓存文件 (db.json) 和已生成的静态文件 (public)

七、部署

在所有东西都弄完之后，访问确实没问题，然后将其托管在GitHub上：

$ hexo deploy 或者 $ hexo d          // 将网站部署到服务器上

部署好了会出现这个：

大功告成，然后在网上就可以直接通过GitHub Pages访问了：

参考☟☟☟：
如何搭建个人独立博客？
笨方法学写作个人网站
https://zhuanlan.zhihu.com/p/25729240
Hexo官网文档
小歪的博客

本文的所有内容均是一字一句敲上去的，希望大家阅读完本文可以有所收获，因为能力有限，掌握的知识也是不够全面，欢迎大家提出来一起分享！谢谢O(∩_∩)O~

欢迎访问我的GitHub，喜欢的可以star，项目随意fork，支持转载但要下标注

个人博客

等一下( •́ .̫ •̀ )，我还有最后一句话：

我爱你，

如果有一天，

你一无所有，

我是你最后一件行李，

我们永远不再见