经过各种找资料，踩过何种坑，终于搭建好了 hexo，域名目前用得时 github 的，我的 hexo 是 3.2.2 版本，hexo 不同的版本，很多配置都不一样。好吧，废话不多说了，开始吧。
之前是想着写博客，一方面是给自己做笔记，可以提升自己的写作、总结能力，一个技术点我们会使用，并不难，但是要做到让让别人也能听懂我们讲得，还是需要一定的技巧和经验的。很多类似于 CSDN、博客园也都可以写文章，但是页面的样式我不是太喜欢，简书还算好点得。最近看到一些大神们的博客，貌似都是用 hexo 写得，我也依葫芦画瓢的搭建了一个。不罗嗦了，直接上搭建步骤。
简介
hexo是一个npm包，在node环境上运行，功能就是将你的文章（.md文件）生成为静态html文件。
基础准备
下面正式开始搭建博客！首先要想使用 Hexo 和 github pages 搭建博客，需要以下环境：
- 在
github上注册一个账号，并创建一个指定名字的reposity -
homebrew套件管理器，主要用来安装git和node.js -
git版本管理工具 node.js- 配置
SSH key - 安装
hexo - 同步
hexo博客到github
注册Github账号并创建reposity
申请完账号，登陆之后，就可以创建 reposity 了，点击 New repository
，会跳转到这个界面:
安装brewhome
ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)”
安装失败, 执行以下脚本卸载：
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall)"
报错：Failed to locate Homebrew!
执行以下:
sudo rm -rf /usr/local/.git rm -rf Library .git .gitignore bin/brew README.md share/man/man1/brew rm -rf ~/Library/Caches/Homebrew
成功后，再次执行，下载脚本：
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
下载成功
安装git版本管理工具
git 是一个强大的版本管理工具，github 的版本管理就是基于 git 的，现在 svn 基本过时了，使用 Git 进行版本管理才是王道。安装完 homebrew 之后，安装 Git 几乎零成本，还是在 terminal 终端，输入以下命令：
brew install git
然后等一段时间就 ok 了，homebrew 会自动去帮你完成下载安装。
安装node.js
hexo 是基于 node.js 的，所以要让 hexo 运行，node.js 环境是必不可少的。使用 homebrew 安装 node.js 也特别简单，在 terminal 终端输入如下命令：
brew install node
ps：安装最新版的 Node.js 之后，我们就可以使用 npm 命令，在 mac 下遇到 npm 命令找不到的问题，解决方案如下：
sudo ln -s /usr/local/bin/node /usr/bin/node
sudo ln -s /usr/local/lib/node /usr/lib/node
sudo ln -s /usr/local/bin/npm /usr/bin/npm
sudo ln -s /usr/local/bin/node-waf /usr/bin/node-waf
安装hexo
前面我们安装了 node.js，装完 node.js 之后，我们就可以使用 npm 命令了，而 hexo 安装就是使用 npm，在终端输入以下命令：
npm install -g hexo
ps：等待一会儿，hexo 会自动完成下载安装。等 hexo 安装完成之后，在创建一个文件夹，这个文件夹以后就是你存放本地博客的地方了。
搭建hexo博客
创建新建一个文件夹，用来存放本地博客。
hexo init
npm install
hexo会在创建的文件夹创建本地博客所需的一切资源。
hexo server
访问本地localhost:4000可以看到博客已经搭建成功。
同步hexo博客到github
- 配置本地和
github的ssh - 在
github上创建名字为XXX.github.io的项目，XXX为自己的github用户名。 - 开本地的创建的文件夹中的
_config.yml配置文件，将其中的type设置为git。
检查你电脑上现有的ssh key
cd ~/.ssh # 切换到ssh目录
ls -al ~/.ssh # 查看
注意：
如果你本地没有生成的话，终端上面会显示，No such file or directory。说明你是第一次使用git，如果已经存在的话，则会显示id_rsa和id_rsa.pub。
获取ssh
ssh-keygen -t rsa -C "your.email@example.com" -b 4096
配置github的ssh
登陆github后，点击右上角自己的头像–>点击Your profile–>点击你的博客远程仓库，页面中就能找到ssh。
安装自动部署发布工具
这里用到了 hexo-deployer-git，使用如下命令安装：
npm install hexo-deployer-git --save
配置hexo
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: https://github.com/sunjinshuai/sunjinshuai.github.com
branch: master
在terminal终端，执行以下命令：
hexo generate // 可以简写成hexo g 根据markdown文件生成静态文件
hexo deploy // 或者简写成hexo d 将本地修改，部署到远端
此时，打开浏览器，访问https://sunjinshuai.github.io ，就可以看到你的博客。
Hexo安装新主题apollo
Hexo换皮肤还是比较简单的，既可以自己根据默认的主题来修改，也可以到https://hexo.io/themes/ 上去找主题。
安装
github上的文档给出了详细的安装命令：
hexo init #blogname#
cd #blogname#
npm install
npm install --save hexo-renderer-jade hexo-generator-feed hexo-generator-sitemap hexo-browsersync hexo-generator-archive
git clone https://github.com/pinggod/hexo-theme-apollo.git themes/apollo
启用
安装成功后就可以开始启用主题，主题的启用需要修改_config.yml 的 theme 配置项为 apollo：
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: apollo
# 在归档页面显示所有文章
# 需要上面安装的 hexo-generator-archive 插件支持
archive_generator:
per_page: 0
yearly: false
monthly: false
daily: false
hexo常用的命令
hexo init //在指定目录执行该命令，会将当前目录初始化为hexo站点，生成hexo站点所需的一切文件
hexo new “my new blog title” //新建一篇文章。如果没有设置 layout 的话，默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话，请使用引号括起来。
hexo clean // 清除缓存，如果对本地文件做了修改，同步到远程验证修改的效果之前，先clean，清除缓存
hexo generate // 可以简写成hexo g 根据markdown文件生成静态文件
hexo server // 或者简写成hexo s 启动本地hexo 服务器，默认localhost:4000可以访问
hexo deploy // 或者简写成hexo d 将本地修改，部署到远端
hexo version // 显示hexo版本
关于HEXO安装失败的解决方法
目前国内npm源有问题；所以键入如下代码即可安装成功:
npm install -g cnpm --registry=https://registry.npm.taobao.org
cnpm install hexo-cli -g