（酝酿了好久，终于要开始写武功秘籍了。隔................）
即使已经在网上看过很多大佬写的教程，但是首次搭建仍会遇到许多问题。在这里，我记录了我搭建博客的过程，贴上我踩过的坑，一方面是做个整理，另一方面是帮助看到文章的人走些弯路。
本文主要介绍win10下hexo3.2.2+github的搭建（不同的hexo版本，有的设置可能会有差异）。
搭建环境
1. 安装git
可以到git官网下载相应平台的版本进行安装。考虑到你可能是无照驾驶，直接在github/git下载。
2. 申请github账号
进入github注册。此处省略一千字。
3. 安装node.js
到node.js官网下载相应平台的最新版本，傻瓜式安装（自带安装npm）。
4. 安装hexo
打开git bash或者cmd，执行以下命令:
npm install -g hexo
搭建hexo
首先创建一个文件夹，如blog，用来存放hexo的配置文件等，然后进入blog进行操作。
1. 初始化
右键 git bash，执行以下命令:
hexo init
2. 安装依赖包
npm install
3. 生成静态页面
hexo generate或者hexo g
4. 本地运行
hexo server或者hexo s
打开浏览器，在地址栏输入localhost:4000，就可以看到我们搭建好的本地博客了。到此只是搭建好了本地博客，还需要将博客部署到github上。
配置github
1. 新建repository
建立与你用户名对应的仓库，仓库名必须为【 your_username.github.io】，例如我的是xiaobinhong1.github.io。
2. 部署博客
进入你的hexo文件夹根目录下，用编辑器打开_config.yml，修改deploy项，如下（根据你的github进行相应更改）：
deploy:
type: git #注意：有的版本type是github
repo: https://github.com/xiaobinhong1/xiaobinhong1.github.io.git
branch: master
此时就完成部署了，用浏览器访问xiaobinhong1.github.io即可(第一次发布可能会有10分钟的延迟)。
每次修改完本地的文件后要执行以下命令，重新部署到github上：
hexo clean
hexo generate
hexo deploy或者hexo d
常用命令
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy #将.deploy目录部署到GitHub
hexo help # 查看帮助
hexo version #查看Hexo的版本
报错总结
1.出现 error deployer not found:git 或者 error deployer not found:github 的错误
解决办法：执行 npm install hexo-deployer-git --save
2.出现类似 FATAL can not read a block mapping entry; a multiline key may not be an implicit key at line 70, column 1: ... 错误
解决办法：_config.yml中配置项的冒号后面要用空格隔开，再跟内容
3.中文乱码问题
解决办法：将文件的内容编码改为UTF8格式
4.'hexo sever'能够成功运行，但是localhost:4000无法访问
解决办法：执行hexo s -p 5000，改用其他端口启动
网友评论