2018最新版hexo+Github搭建个人博客教程（2018-1-22 更新） - 好文

前言

现在是大三了，身边的甚多朋友技术都还不错，动不动就搭建自己的网站什么的。本着向大佬学习（zhuangbi）的心情，我也开始在阿里云上面买了一个云服务器（学生套餐9.9），使用phpstudy软件一键部署了一个web服务器。但是想想其实没什么用，我只是想找一个属于自己的个人博客而已。所以将目光转向了hexo。
经过很多的摸索，终于是做好了我的博客：http://bianxiaofeng.com <http://bianxiaofeng.com>, 就像每个语言入门必写
hello world一样，我也想把自己使用hexo的相关经历写下来，方便自己以后查阅也希望能够帮助到更多的朋友。

博主使用是Windows10操作系统，其他系统自测。

总述

搭建的过程分为以下几步：

*
安装Node.js

*
安装Git软件

*
安装hexo博客框架

*
测试本地运行（线下访问个人博客）

*
部署到Coding以及GitHub上（线上访问个人博客）

*
设置域名解析

*
其他（写一篇新的博文，设置categories,tags）

安装Node.js

Node.js下载地址：https://nodejs.org/en/download/ <https://nodejs.org/en/download/>

安装过程一路默认安装即可。

详细安装文档参看：http://www.runoob.com/nodejs/nodejs-install-setup.html
<http://www.runoob.com/nodejs/nodejs-install-setup.html>

安装Git软件

Git软件下载地址：https://git-scm.com/download <https://git-scm.com/download>

安装过程一路默认安装即可。

关于更多的Git讲解参看：

https://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000

<https://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000>

安装Hexo

什么是 Hexo？

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

Hexo官方网站：https://hexo.io/zh-cn/ <https://hexo.io/zh-cn/>

安装

安装命令：
npm install -g hexo-cli #-g表示全局安装
这里提一下：关于hexo的终端操作最好是在管理员模式下，读者可以采用按住Shift然后再点击鼠标右键选择弹出菜单的在此处打开Powershell窗口
保证运行在管理员状态下。

初始化hexo

在电脑合适的位置新建一个文件夹存放博客。本文中取名为Blog文件夹。

控制台命令行使用cd命令进入到Blog文件夹，输入以下命令进行初始化：
hexo init # 初始化
初始化完成之后，因为会出现有些依赖包未安装成功的情况，所以请再输入以下命令安装依赖包:
hexo install # 安装依赖包
测试本地运行

完成以上安装步骤后，便可以在本地预览博客效果了。

输入以下命令：
hexo g # 等同于hexo generate，生成静态文件 hexo s # 等同于hexo server，在本地服务器运行
然后打开浏览器地址栏输入：http://localhost:4000/ <http://localhost:4000/>便可以预览生成的博客框架雏形了。

部署到GitHub以及Coding上

建立博客网站肯定是要让大家看到的，由于Github是歪果仁的网站，且禁止百度爬虫访问，所以会导致百度搜不到你的网站。所以我们要做好两手准备：国内采用Coding托管，国外采用GitHub托管。

分别注册GitHub以及Coding的账号。

*
GitHub网址如下：http://www.github.com <http://www.github.com>

*
Coding网址如下：https://coding.net <https://coding.net>

GitHub注册

1、在GitHub首页点击Start Project

2、创建Repository

PS：创建时，填写Repository name的时候，Repository
name的格式必须为{user_name}.github.io，其中{user_name}必须与你的用户名一样，这是GitHub
Pages的特殊命名规范（亲测不区分大小写）。

Coding注册

CODING 是国内专业的一站式云端软件服务平台，成立于 2014 年 2 月，总部位于深圳，并于北京、上海、成都、西雅图设立分部，已获得了 IDG
和光速的两轮投资共计 1500 万美元。旗下自主研发运营 Coding.net 云端开发协作平台，累积 25 万开发者，37
万个项目。在云计算时代，把代码托管、产品演示、WebIDE 等开发工具集成到浏览器中，免除繁杂的开发环境部署，节省成本，帮助软件开发者提高生产效率，并实现
“Coding Anytime Anywhere” 的愿景。2015 年 10 月，基于 Coding.net 的工具平台，CODING
推出云端软件众包服务平台 “码市”，旨在通过云端协作以及众包的方式提高软件交付的效率，帮助软件开发行业实现高效的资源匹配。

Coding.net 为开发者提供了免费的基础服务，包括但不限于 Git 代码托管，项目管理，Pages 服务，代码质量管理。您可以在 Coding.net
一站完成代码及代码质量，项目及项目人员的管理，Coding.net 让开发变得前所未有的敏捷和简单。

Coding的仓库容量只有256M，但是用来发布博文是够了的。

注册步骤没啥好说的。

主要说一下创建仓库的时候（顺便说一句：Coding毕竟还是国内的，各方面比较适合国人的习惯，操作起来是比GitHub顺手点。）

点击下面的“加号”创建一个仓库：

然后输入项目名称以及项目描述：

此处的项目名称不像GitHub那样有着严格的命名规范，你可以按照你能想象到的方式输入。建议不要输入中文，不然后面会走的很安详。这里我是输入的自己的用户名作为项目名称。

开启Pages服务（步骤如下图）

选择部署来源为master分支，然后点击 http://username.coding.me/yourRepoName
<http://username.coding.me/yourRepoName>就可以查看你的博客了，不过你点进去是404，因为你仓库里面啥都没有。

到此，注册和创建仓库一步骤已经全部完成了。

部署到线上（GitHub和Coding）

我看到很多博客上面说到配置文件的时候，没有区分站点配置文件和主题配置文件，这里我先说清楚。站点配置文件和主题配置文件名称都是一样的_config.yml
，站点配置文件在网站根目录，主题配置文件在根目录下的theme文件的具体theme下的_config.yml。

修改站点配置文件

打开_config.yml到最后deploy选项：
配置如下：
# Deployment ## Docs: https://hexo.io/docs/deployment.html deploy: type: git
repo: github: https://github.com/DimpleFeng/dimplefeng.github.io.git,master
coding: https://git.coding.net/DimpleFeng/test.git,master
注意：每个冒号后面都是有一个空格的，这是node的语法。

部署

部署之前需要安装git部署插件，否则会提示Deployer not found错误。
npm install hexo-deployer-git --save
安装完毕后控制台输入：
hexo g -d
随后访问你的以下网址（注意替换）：

yourName.github.io
<https://blog.csdn.net/qq_32454537/article/details/yourName.github.io>
yourName.coding.me
<https://blog.csdn.net/qq_32454537/article/details/yourName.coding.me>

设置域名解析

作为一个有梦想的程序员，总是希望拥有自己别具一格的域名，这怎么办呢，你可以选择购买域名，然后指向你的静态pages。具体怎么做呢，请看下面。

购买域名

你可以在腾讯云 <https://dnspod.cloud.tencent.com/?from=qcloudHpProductDns>以及阿里云
<https://wanwang.aliyun.com/?utm_content=se_1101812>上购买你的域名。

我是分别在阿里云上和腾讯云上购买过域名。分别是www.bianxiaofeng.top和www.bianxiaofeng.com。
.top域名已经没有使用了（2元一年是相当的便宜），这里想说的是，这两个代理商的操作模式有些不同。

设置域名解析

这里我分别以阿里云和腾讯云的举例：

腾讯云

进入腾讯云DNS解析网站 <https://console.cloud.tencent.com/domain/mydomain>，然后是点击解析。

添加如图所示的几条解析指令。

注意：此处的记录名是github填写你的仓库名，Coding按照我上面的填写。

阿里云

进入阿里云DNS解析网站 <https://dc.console.aliyun.com/dns/>点击解析设置：

添加以下几条解析命令：

设置Coding和GitHub

按照上面的步骤添加完毕之后，分别设置Coding和GitHub的指向。

Coding

打开Coding，然后点击你的网站仓库，按照下面的步骤，添加你的域名

GitHub

在你的博客的文件夹中找到Source文件夹，在里面加添一个CNMAE的文件，文件内容为你的域名，比如我的就是：bianxiaofeng.com

OK ,大功告成，你可以通过你的域名访问你的网站了。Dimple <http://www.bianxiaofeng.com>

其他

写一篇新的博文

两种方法：
- 在博文根目录的Source文件夹的post文件夹下直接新建一个md文件
- 在博文根目录打来PowerShell，然后输入hexo new '你的标题'回车在你的post文件夹下就新建了一个博文，打开编辑即可。然后使用hexo
g -d部署到线上。

后续

接下来呢，我还会针对Next主题、相关的网站配置以及域名和百度谷歌收录进行说明，欢迎关注我的系列文章。

总结

洋洋洒洒的写了4000+字，确实每一步都是在仔仔细细的做，记录。这篇博文参考了hexo的官方文档，以及百度谷歌的各种教程，重复杂乱居多，网上各种文章都是复制粘贴重复很多且不是最新的，我只想用最平凡的文字记录最清晰的道路。我是一个被代码耽误的诗人，这是我朋友给我的评价哈哈哈。

热门工具换一换