错误：无效模板 - 个模板有语法错误

问题特征

我正在使用 Copenhagen 主题在本地处理主题，并在调用时遇到以下错误 InvalidTemplates - 带有语法错误的模板yarn install 和 yarn start.

解决步骤

出现此错误的原因通常是 Handlebars 中的格式问题。 .hbs 模板。它通常由结构不正确的列表或对象触发，例如映射中的项目过多、数组或对象格式错误，或不受支持的表达式 assets.hbs.

如果您的主题manifest.json包含的数组或对象含有过多项目、缺失字段或无效结构。这对于在设置面板中定义的变量尤其常见。此外，该错误也可能是由于模板文件中存在不受支持的语法所致，例如 assets.hbs 或者当某些循环助手或映射超出其限制时。

要解决此错误，请完成以下故障排除步骤：

• 第 1 步：检查您的 assets.hbs
• 第 2 步：Manifest 设置问题
• 第 3 步：检查模板化版本问题
• 第 4 步：重建并测试

第 1 步：检查您的 assets.hbs

确保您的映射或数组位于assets.hbs未超过允许的项目数。Zendesk 主题模板中的一些助手对映射（例如列表或字典）中的项目数量强制执行严格限制。

以下是一些典型原因：

• 在映射或列表中添加了过多项目.hbs 文件中经常包含的大循环或静态映射/列表都可能触发此问题。
• 使用当前模板化版本不支持的语法。
• JSON 或 Handlebars 表达式格式错误。

以下是项目过多列表的示例：

{{#each largeArray}}
 ... output ...
{{/each}}

如果largeArray超出助手的允许限制，系统将返回此错误。

第 2 步：Manifest 设置问题

如果错误引用了 manifest 或settings，检查是否：

• 任何变量标识符的长度都超过 30 个字符，且包含短划线 - 而不是下划线 _、 或 有大写字母。
• 设置组等映射超出系统限制，例如变量总数超过 200 个，或列表中的选项超过 20 个。
• 所有必需的变量，例如 logo和favicon 有。
• 所有列表变量都有至少两个选项，且不超过 20 个。

第 3 步：检查模板化版本问题

检查模板化版本兼容性：

• 如果您已将主题从 API 版本 1 或 3 升级到版本 4，请确保所有助手和块都是兼容的。一些较早的助手，例如 {{request_form}}，在版本 4 中不再受支持，必须根据升级指南进行替换。
• 使用 Zendesk 模板系统不支持的部分或高级映射语法也会触发此错误。

第 4 步：重建并测试

进行更正后：

1. 保存所有更改。
2. 运行 yarn start 以重新编译主题。
3. 确认该错误不再出现。

有关更多信息，请参阅文章：在本地处理主题

翻译免责声明：本文章使用自动翻译软件翻译，以便您了解基本内容。 我们已采取合理措施提供准确翻译，但不保证翻译准确性

如对翻译准确性有任何疑问，请以文章的英语版本为准。