错误分析
如果你使用Hexo遇到同样的问题,这里有一些常见问题的解决方案。
YAML Parsing Error
1 | JS-YAML: incomplete explicit mapping pair; a key node is missed at line 18, column 29: |
- 参数中包含冒号,请用加引号,如
Last updated: %s
1 | JS-YAML: bad indentation of a mapping entry at line 18, column 31: |
- 字段后面的冒号必须为英文冒号,如:last_updated:
- 字段冒号后面必须跟一个空格,如:last_updated: “Last updated: %s”
EMFILE Error
1 | Error: EMFILE, too many open files |
生成大量的文件时,可能遇到EMFILE错误。
可以运行以下命令来增加允许同步I / O操作的数量。
1 | ulimit -n 10000 |
Process Out of Memory
当hexo g
时,遇到以下错误:
1 | FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - process out of memory |
如下,更改hexo-cli
文件的第一行,来增大nodejs堆内存.该bug已在新版本修复。
1 |
Git Deployment Problems
- RPC failed
1 | error: RPC failed; result=22, HTTP code = 403 |
确保你有你的电脑上设置git正确或尝试使用HTTPS存储库URL。
- Error: ENOENT: no such file or directory
这个需要有一定的git的知识,因为可能是由于写错了标签,类别,或文件名,导致本地和github冲突了,Git不能自动合并这一变化所以它打破了自动分支。
解决办法:
- 检查文章的标签和类别,确保本地和github上是相同的。
- 合并分支(Commit)。
- 清除,重构。在站点目录下,命令行(即Git Bash)运行
hexo clean
和hexo g
- 手动将站点目录下的
public
文件夹复制到您的桌面 - 从你的master分支切换到部署在本地分支。
- 从桌面复制
public
文件夹到本地分支。 - 合并分支到github(Commit)。
- 切回master分支。
Server Problems
1 | Error: listen EADDRINUSE |
你可能使用相同的端口,同时开启了两个Hexo服务器。如果需要同时开启,可以尝试修改端口设置:
1 | $ hexo server -p 5000 |
Plugin Installation Problems
1 | npm ERR! node-waf configure build |
这个错误可能发生在试图安装一个用Cc++或另一个javascript语言编写的插件。确保您已经安装了正确的编译器在您的计算机上。
Error with DTrace (Mac OS X)
1 | { [Error: Cannot find module './build/Release/DTraceProviderBindings'] code: 'MODULE_NOT_FOUND' } |
DTrace安装可能有问题,重装:
1 | $ npm install hexo --no-optional |
详见 #1326
Iterate Data Model on Jade or Swig
Hexo使用仓库的数据模型。这不是一个数组,所以你可能需要将对象转换为iterable。
1 | {% for post in site.posts.toArray() %} |
Data Not Updated
一些数据不能更新或新生成的文件的最后一个版本完全相同。清理缓存,再试一次:
1 | hexo clean |
No command is executed
那个不能使用除help
、init
和version
以外的命令行(即Git Bash)时, 有可能时站点目录下的 package.json
文件,缺少hexo
,如下:
1 | { |
Escape Contents
Hexo使用Nunjucks渲染的页面. { { } }
或{ % % }
将解析和可能会引起麻烦, 如果要在博文中出现,必须使用三引号:
1 | |
1
2
ENOSPC Error (Linux)
如果运行命令$ hexo server
返回一个错误:
1 | Error: watch ENOSPC ... |
可以通过运行$ npm dedupe
或者以下命令行(即Git Bash):
1 | echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p |
来增加测试时,你可以看见的文件数量。
EMPERM Error (Windows Subsystem for Linux)
如果在Windows Subsystem for Linux,运行命令$ hexo server
返回这个错误:
1 | Error: watch /path/to/hexo/theme/ EMPERM |
因为目前在Windows Subsystem for Linux中,有些内容更改时,还不能实时更新到hexo服务器。
所以需要重新编译,再启动服务器:
1 | $ hexo generate |
Template render error
有时运行命令$ hexo generate
返回一个错误:
1 | FATAL Something's wrong. Maybe you can find the solution here: http://hexo.io/docs/troubleshooting.html |
这意味着有些认不出来单词在你的文件,并且很可能在你的新博文,或者配置文件_config.yml
中,比如缩进错误:
错误例子:
1 | plugins: |
###
如果本文对您有用,谢谢打赏。