Shopify metafield 填了却不显示，先分清是数据还是模板

分清“数据已保存”和“模板会展示”

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

检查商品实际使用的模板

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

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

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