> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 模板显示错误或无法预览

> 读懂模板编辑器中的代码错误，修复无法渲染的预览，并了解模板更改为何没有显示在文档上。

当模板代码有错误时，编辑器会告诉您错误所在，预览会等到错误修复后再更新。本文介绍这些提示信息，以及更改没有显示在文档上时该怎么做。

## 编辑器中的代码错误

**代码错误**横幅会列出每个问题及其行号，例如 *第 12 行 - 未知的 Liquid 过滤器：'money\_with\_curency'*。选择**跳转到该行**即可定位到该处。

常见错误：

| 错误 | 通常的含义 |
| - | - |
| *未闭合的 Liquid 标签*或*未闭合的 Liquid 输出标签* | 某个 `{% ... %}` 或 `{{ ... }}` 缺少结尾的 `%}` 或 `}}`。 |
| *未知的 Liquid 过滤器*或*未知的 Liquid 标签* | 拼写错误，或使用了仅在 Shopify 主题中有效的过滤器或标签。 |
| *未知的 Liquid 对象* | Foliant 无法识别的变量名。请检查拼写。 |
| *Liquid 语法错误* | Liquid 语句中有格式错误，例如 `if` 缺少 `endif`。 |
| *未闭合的“`<div>`”标签*、*意外的结束标签*或*缺少结束……* | HTML 标签没有正确配对。 |
| *未知的 CSS 属性* | 样式中有拼写错误。 |

存在错误时，预览会显示*请修复代码错误以更新预览*。您也无法切换到可视化编辑器：*请先修复代码错误，再切换到可视化编辑。*

## 预览无法渲染

| 提示信息 | 处理方法 |
| - | - |
| *无法渲染预览。请检查模板中的 Liquid 错误。* | 查找编辑器未发现的错误，例如对错误类型的值使用了过滤器。请尝试用其他订单预览。 |
| *无法渲染 PDF。请修复模板中的错误后重试。* | 修复错误，然后再次选择**预览 PDF**。 |
| *检测到未保存的更改*：*请保存更改以生成预览。* | 保存模板。 |
| **由较新版本的 Foliant 保存** | 重新加载页面，以编辑模板的区块。 |

如果您找不到错误，可以从模板历史中恢复较早的版本。请参阅[模板历史](https://foliant-help.iforiti.com/cn/templates/version-history.md)。

## 更改没有显示在文档上

* **需要发布。**如果在**设置 › 文档与打印**中开启了**需要发布**，您对模板代码、水印或纸张尺寸保存的更改会一直是草稿，直到您发布为止。客户、导出和打印仍使用已发布的版本。
* \*\*文档已锁定。\*\*已开具且已锁定的发票和贷项通知单不会再更改。请参阅[已锁定的发票](https://foliant-help.iforiti.com/cn/invoices-and-numbering/locked-invoices.md)。
* \*\*客户最近打开过链接。\*\*下载链接会在几分钟内同步模板更改。
* \*\*该订单使用了其他模板。\*\*请在模板分配中查看该订单使用的是哪个模板。

## 小贴士

* 您在打印页面上所做的一次性编辑不会保存到模板中。
* 有些信息会特意打印为空：清单或拣货单涵盖多个订单，因此单个订单的信息（例如订单号）在其中为空。

## 相关文章

* [代码编辑器](https://foliant-help.iforiti.com/cn/template-editor/code-editor.md)
* [模板历史](https://foliant-help.iforiti.com/cn/templates/version-history.md)
* [文档或页面无法加载](https://foliant-help.iforiti.com/cn/troubleshooting/documents-dont-load.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.