安装步骤
网络上关于 Hexo博客的安装教程已经多如牛毛,我觉得自己没有必要重复造轮子。安装教程大多数基于windows环境,其实linux环境下也大同小异的。
大体步骤如下:
- 了解Hexo :hexo.io
- 安装git :GitHub Windows
- 安装Node.js : Node.js
- Hexo初始化配置 : Hexo Setup
- 部署静态网页到GitHub
详细步骤参考:使用GitHub和Hexo搭建免费静态Blog
问题及解决
下面主要我在建站过程中遇到的问题和解决方法,仅供参考。
yml文件忘加空格错误
安装Hexo时,在配置_config.yml文件的过程中,如果参数冒号后面忘记加空格就会报错:
FATAL can not read a block mapping entry; a multiline key may not be an implicit key at line 8, column 12
解决办法:yml文件格式问题,你自己检查一下是不是冒号后面没有写空格。

npm 警告
提示如下:
npm WARN optional dep failed, continuing fsevents@1.0.8
目前没有去解决,似乎不会影响建站。
缺少.git文件报错
发生环节:windows下,将本地Hexo部署到github时。
将会有以下几种错误提示:1
2
3
4
5spawn git ENOENT
ERROR Deployer not found: github
fatal: Not a git repository (or any of the parent directories): .git
截图如下:


解决方案:在Hexo的安装目录下生成.git文件,然后deploy一下。
随后有可能会遇到版本不一致的问题,需要同步一下。
具体操作:
- 检查blog blog 目录下的 _config.yml 文件
1 | deploy:</br> |
安装插件
npm install hexo-deployer-git –save发布页面
hexo g #创建静态页面
hexo d #发布:清空.deploy_git/里文件,从public/复制新生成的文件解决
fatal: Not a git repository (or any of the parent directories)错误
使用everything搜索隐藏目录下的.git文件复制到Hexo文件的.deploy_git目录下。再次运行hexo d。如果上一步骤出现
Permission denied或者提示版本不一致问题,首先cd 到.deploy_git下,然后处理版本问题。
6.git版本冲突问题解决
1 | git init #解决fatal: Not a git repository (or any of the parent directories): .git |
我的Hexo下,.git安装路径为E:\hexo\blog\\.deploy_git\\.git
是由于远程仓库中代码版本与本地不一致冲突导致的。
解决:git pull
再自动merge或手动merge冲突,
再次git push,
成功解决问题。
参考:Git push 报错
无法访问github.com错误
Fatal Error : Can't resolve host github.com
我遇到的只是暂时性无法访问,多试几次就可以了。