商品 metafield 不出现在动态源下拉列表里

现象#

商品已填好自定义字段，在编辑器点某个文本设置的「连接动态源」，列表里只有商品标题、描述，找不到自建的 metafield。

原因#

• setting 与 metafield 类型不兼容，图片设置只接受 file_reference，文本字段不进列表
• 当前 section 不在商品模板内，编辑器只提供与当前模板资源对应的 metafield
• 字段是早期直接写 namespace 与 key 的无定义 metafield，没有 definition 不进选择器
• 定义属于已卸载应用的命名空间，或定义被删除、改名

处理步骤#

1. 到 设置 → 自定义数据 → 商品 确认该字段存在定义，并记下它的类型
2. 按类型配对：文本用 single_line_text_field，图片用 file_reference
3. 把该 section 放进 templates/product.json 后再打开编辑器验证
4. 为无定义字段补建定义，命名空间与 key 必须与已有数据一致
5. 刷新编辑器重新点「连接动态源」，确认列表出现该字段名

验收标准#

下拉列表出现该 metafield 名称，选中后前台输出对应商品的值，切换商品内容随之变化。