Shopify 主题前台显示 translation missing 怎么修

现象#

切换语言后前台出现 translation missing: zh-CN.products.add_to_cart，中文语言包里找不到对应 key。

原因#

• 语言文件 locales/zh-CN.json 缺失该 key，或层级结构与默认 en.default.json 不一致
• 代码里写的 key 带拼写错误或多余空格
• 新增的 key 只加到了 en.default.json，其他语言没同步
• 主题更新覆盖了自定义语言文件

处理步骤#

1. 在 locales/en.default.json 里找到该 key 的完整路径，逐层比对中文文件
2. 补齐缺失 key，保持 JSON 结构一致，注意不要留下尾逗号
3. 用 shopify theme check 的 MissingTemplate / 翻译相关规则扫描
4. 发布前把自定义翻译导出备份，主题升级后重新导入合并

验收标准#

切换各语言后前台不再出现 translation missing；theme check 无缺失 key 提示。