Shopify 变体选项名无法翻译怎么办

现象#

切换到德语市场后，商品标题已翻译，但尺寸下拉里仍是「Size / Color」，选项值也是英文。

原因#

• 选项名与选项值属于商品数据，需要在 Translate & Adapt 里单独翻译，不会跟随主题语言包
• 翻译应用只同步了标题与描述，没有覆盖 product_option 资源
• 主题用 option.name 直接输出，没有走翻译后的 option.name 本地化值
• 部分语言的市场未启用，前台根本不会请求该语言的翻译

处理步骤#

1. 到 应用 → Translate & Adapt，选择目标语言，进入该商品的选项与选项值逐项填写翻译
2. 确认该语言对应的市场已启用，并且前台语言切换器能切到该语言
3. 主题里改用 {{ option.name }} 输出（Shopify 会返回当前语言的翻译），不要硬编码中文或英文标签
4. 用 API 写入时通过 translatableResourceUpsert 提交 PRODUCT_OPTION 与 PRODUCT_OPTION_VALUE 的 key
5. 清除 CDN 缓存后切换语言复查，必要时换无痕窗口

验收标准#

目标语言下选项名与选项值均显示翻译文案，切换回默认语言后恢复原文，商品页无报错。