Shopify metafield 已填写但商品页不显示，怎样排查？

区分数据已保存和模板已展示

先从当前商品打开 metafield，核对 namespace、key、字段类型和实际值；再确认浏览器查看的就是这个商品及其已发布主题。复制主题预览、市场缓存或把值填到相似商品上，都可能让后台与前台看起来不一致。

检查商品使用的真实模板

Shopify 的metafield 展示说明要求将数据连接到支持 dynamic source 的主题区块，或在代码中用 Liquid 引用。进入该商品实际分配的模板，检查区块、连接图标和选中的字段，而不是只修改默认商品模板后假设全部商品都会继承。

让有值和空值都能正常显示

若可视化区块不接受该字段类型，先查主题文档；确需代码时，在共享组件中读取正确字段并对空值做条件判断。用一个有值商品和一个空值商品测试桌面与手机，确认不会显示空标题、破坏布局或把文件、引用列表当普通文本输出。