Shopify中使用Liquid获取带元字段的商品描述问题求助

一、获取默认商品描述 #

如果要调用商品后台填写的默认主描述，直接用内置属性即可，无需依赖自定义元字段：

{{ product.description }}

二、自定义元字段描述的排查与修复 #

你当前使用的是自定义元字段调用，出现非预期结果可按以下步骤排查：

1. 确认元字段结构与内容
   先输出整个元字段的JSON结构，查看实际存储的内容：

   {{ product.metafields.custom.us_product | json }}
   

   通过输出结果确认该元字段是否存在，以及是否真的包含description嵌套属性。

2. 检查元字段权限
   登录Shopify后台，进入「设置→元字段→商品」，找到custom.us_product字段，确保勾选了「在商店front中可见」，否则前端Liquid无法读取该字段。

3. 修正调用路径

   • 如果元字段存储的是纯文本描述（而非嵌套对象），直接调用值即可：

     {{ product.metafields.custom.us_product.value }}
     

   • 如果是嵌套对象，根据JSON输出的实际键名调整路径，比如实际结构是{"desc":"商品描述内容"}，则改为：

     {{ product.metafields.custom.us_product.value.desc }}
     

4. 添加容错兜底
   为避免元字段不存在时页面显示异常，可添加条件判断兜底显示默认描述：

   {% if product.metafields.custom.us_product.value.description %}
     {{ product.metafields.custom.us_product.value.description }}
   {% else %}
     {{ product.description }}
   {% endif %}
   

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