从零开始的Hexo博客搭建教程（七）：遇到的坑

✨《从零开始的 Hexo 博客搭建教程(how-to-build-hexo-blog)》终于到了第七辑啦！

本文用于 收集本人在使用 Hexo 的过程中出现的 各种坑及解决方法。

如果你有更好的解决方法或遇过的坑，欢迎在评论区分享喔 ο(=•ω ＜=)ρ⌒☆

Template render error

问题描述

在使用 hexo g 生成文章的时候，控制台报错如下:

1
2
3

FATAL Something's wrong. Maybe you can find the solution here: http://hexo.io/docs/troubleshooting.html
Template render error: (unknown path) [Line 12, Column 17]
expected variable end

出现原因

当文章中有 }} 或 EJS 模板语法，且未被代码块包含时，解析会出现问题。

解决方法

1
2

{% raw %}
放到代码块中就OK啦

注意: 用单反引号包围还是会引发BUG，请使用三反引号包围。

Sitemap.xml 出现错误

问题描述

解决方法

请勿使文章名或 md 文件名包含 & 符号 导致 hexo 文章链接中也包含该符号。

去除后再重新生成即可恢复正常。

ERROR Deployer not found: git

解决方法

执行 npm install hexo-deployer-git --save 即可

之后请一步一步配置

📘《从零开始的Hexo博客搭建教程》系列文章：

1. 从零开始的Hexo博客搭建教程（一）：开始
2. 从零开始的Hexo博客搭建教程（二）：主题
3. 从零开始的Hexo博客搭建教程（三）：SEO优化
4. 从零开始的Hexo博客搭建教程（四）：图床
5. 从零开始的Hexo博客搭建教程（五）：文章发布
6. 从零开始的Hexo博客搭建教程（六）：插件
7. 从零开始的Hexo博客搭建教程（七）：遇到的坑