Hexo - Template render error unexpected token

时间:2022-06-05 22:52:13

问题与分析

今天发现在使用hexo g时报错如下:

FATAL Something's wrong. Maybe you can find the solution here: http://hexo.io/docs/troubleshooting.html
Template render error: unexpected token: }}

一时间很诧异,因为前几天还可以正常生成静态文件,今天忽然就挂了。看看报错的信息,说是模板渲染失败,因为出现了预期外的标志。因为我刚刚写了新的文章,就出现了这个错误,可以想象到,应该是文章中出现了特殊字符导致hexo命令执行失败了。

百度了下,确实如此。因为在Hexo中,有些特殊字符如果不进行转义的话,在渲染模板时就会报错。

解决方法

如果遇到类似的报错,解决方法很简单,就是对这些特殊字符进行转义,需要使用转义标签来将这些特殊字符包括起来,如下:

{% raw %}
特殊字符
{% endraw %}

比如我的报错是因为使用{% raw %}}}{% endraw %},那么就需要对这对大括号进行转义:

{% raw %}
{{ something... }}
{% endraw %}

如果是在引用块里,可以随便使用特殊字符;如果是行内引用块,就需要进行转义了。

参考链接