Hexo搭建静态博客（五）——踩坑问题

本文记录捣鼓hexo博客时遇到的一些踩坑的记录及相关解决思路。

常见报错多在 hexo g 的时候报错

1. YAMLException

ERROR Process failed: _posts/hexo-problem.md
YAMLException: end of the stream or a document separator is expected at line x, column y:
at ...

解决思路：

A. 一般是因为缺少分隔符，缺少空格，key: value ，英文冒号后面留空格，一般错会提示哪个文件的第几行第几列。

B.其次是头部yaml配置

---
key: value
---

缺少也会导致文章内容报错，具体报错的行列位置如果没有问题，就检查头部或者附近标点，或分段测试，该方案适合文章报错

C.还有一些特殊字符，如[ ]也会导致报错，我在title中使用英文[ ]也会报错，但提示的位置没有问题，注意特殊字符使用。

2. 某个ejs或swig文件报错

（1）此类问题一般是使用某个主题之后会出现，注意主题下的配置文件_config.yml检查是否配置，参考（一）A的思路

（2）缺少相关插件如xoxo主题生成时就有readingTime的报错，安装了hexo-reading-time的插件后解决，如是其他同理网上搜一下

npm install   hexo-reading-time --save

(3)使用主题的时候注意先阅读相关使用文档，有些主题需要一些插件

3. 其他

后续补充

相关文章

• Hexo搭建静态博客（一）——基础搭建
• Hexo搭建静态博客（二）——创建页面
• Hexo搭建静态博客（三）——主题更换
• Hexo搭建静态博客（四）——插件安装
• Hexo搭建静态博客（五）——踩坑问题
• Hexo搭建静态博客（六）——项目部署
• Hexo搭建静态博客（七）——客服与推送
• Hexo添加Live2D二次元老婆
• Hexo博客Valine-Admin踩坑记录
• Hexo博客Matery主题valine升级与优化
• Hexo博客Matery主题新手常见问题
• Hexo博客Matery主题添加多级分类
• Hexo博客添加思维导图渲染
• Hexo博客Matery主题添加说说Artitalk教程
• 静态博客-字体更换教程