Shopify locales 语言文件写错整站文案变 key

现象#

改完 zh-CN.json 后刷新中文前台，导航和按钮全变成 general.search 这类键名，切到英文站却完全正常。

原因#

• 语言文件是严格 JSON，多一个逗号或写了注释就会让整个文件解析失败
• 文件保存成带 BOM 或 GBK 编码，读取后键值错乱，匹配不到文案
• 顶层层级与默认语言文件不一致，t 过滤器按路径查不到对应的值
• 只在一个语言文件里新增 key，其他语言缺失时直接显示原始 key

处理步骤#

1. 把 locales/zh-CN.json 内容粘贴到 JSON 校验器，先修语法错误
2. 用编辑器另存为 UTF-8 无 BOM，不要用系统记事本的默认编码
3. 对照 en.default.json 的层级补齐缺失 key，不要改动顶层结构
4. 模板里统一写成 {{ 'products.add_to_cart' | t }}，不要拼接路径
5. 保存后切到中文前台，逐页检查导航、按钮和表单提示

验收标准#

中文前台所有按钮显示正常文案，页面中不再出现点分隔的 key；切换语言后各页面文案都能对应上。