Siteleaf发布时出现RuntimeError：expected "{" 问题排查与解决

成因 #

这个错误来自Siteleaf使用的Liquid模板引擎，核心是Liquid语法结构不完整或解析冲突，具体包括：

• Liquid标签/变量未正确闭合：比如写了{% if post.published %}却没加对应的{% endif %}，或者变量只写了{{ page.title缺了闭合的}}，引擎预期找到{来补全语法结构，从而报错。
• 内容中的特殊字符干扰：文章内容里意外出现{、{{等字符，被Liquid引擎误判为语法标签，但结构不完整，触发解析错误。
• 局部模板（snippets）或布局文件（layouts）存在语法漏洞：引用的子模板本身有未闭合的标签，导致整个页面渲染时出现语法缺失。

解决方法 #

• 检查模板语法完整性：遍历所有自定义布局、局部模板文件，确认所有{% ... %}标签（如if/for循环）都有对应的闭合标签，所有{{ ... }}变量的双大括号成对出现。
• 处理内容中的特殊字符：如果文章内容里需要保留{或类似字符，用{% raw %}和{% endraw %}包裹这段内容，让Liquid跳过解析；或者把{转义为\{。
• 排除法定位问题文件：先切换到Siteleaf默认布局，若错误消失，说明自定义布局有问题；再逐个禁用局部模板，找到引发错误的具体文件。
• 利用日志精准定位：查看Siteleaf预览页面的错误日志，通常会显示错误所在的文件和行号，直接定位问题位置修复。

内容的提问来源于stack exchange，提问作者viraj Chaudhary