Shopify集合元字段存储Liquid语法无法渲染问题排查

核心原因 #

Shopify的模板渲染机制默认会将元字段内容当作纯文本输出，不会主动解析其中的Liquid语法——这是平台的安全设计，目的是防止恶意代码执行。

可行解决方案 #

1. 使用Snippet配合元字段（推荐） #

不要把Liquid逻辑直接存在元字段中，而是将通用逻辑编写在Snippet文件里，元字段仅存储Snippet的名称或者触发参数。
比如元字段collection.metafields.custom.target_snippet的值设为collection-dynamic-content，然后在模板中调用：

{% if collection.metafields.custom.target_snippet %}
  {% render collection.metafields.custom.target_snippet %}
{% endif %}

这种方式符合Shopify最佳实践，既安全又便于代码维护。

2. 使用eval过滤器（仅限Shopify Plus商家，不推荐） #

Shopify Plus商家可以使用eval过滤器强制解析字符串中的Liquid代码，但该方式存在安全风险（若元字段内容被篡改，可能执行恶意代码），官方不推荐生产环境使用。
调用示例：

{{ collection.metafields.custom.liquid_content | eval }}

3. 数据与逻辑分离（更稳妥的替代方案） #

如果需求是为不同集合展示差异化内容，建议将静态/动态数据存在元字段，把Liquid逻辑固定写在模板中。比如元字段存储文案、图片链接、开关状态等，模板里通过Liquid判断、循环等逻辑处理这些数据，既安全又容易调试。

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