Shopify应用块Schema设置多语言翻译失效问题求助
Shopify App Block多语言本地化失效排查方案
1. 修正本地化文件的命名空间(核心问题)
你的组件是App Block而非普通Section,因此本地化文件的顶层键需用block而非section,同时Schema中的翻译路径也要对应修改:
- Schema中的
default值改为:"default": "t:block.schemaTranslations.selectTypeOfProductName" - 本地化文件调整为:
en.default.schema.json{ "block": { "schemaTranslations": { "selectTypeOfProductName": "Select a type of {selectedProductTitle}" } } }zh-CN.schema.json{ "block": { "schemaTranslations": { "selectTypeOfProductName": "选择一种 {selectedProductTitle} 类型" } } }
2. 修复JSON语法错误
你的两个本地化文件中,最后一个键值对末尾存在多余逗号(trailing comma),这会导致JSON解析失败,Shopify会直接忽略该语言文件:
- 去掉
"selectTypeOfProductName": "...",末尾的逗号,确保JSON格式严格合规。
3. 确认文件路径与命名规范
- 确保所有本地化文件放在正确目录:如果App Block定义在
sections/your-block.liquid,则本地化文件需放在sections/locales/目录下,与en.default.schema.json同级。 - 语言代码严格遵循Shopify规范,
zh-CN是简体中文的正确代码,不要写成zh_CN或其他格式。
4. 验证店铺语言设置
- 登录Shopify后台,进入在线商店 > 主题 > 操作 > 编辑语言,确认已启用
中文(简体)并设为店铺可选语言。 - 测试时切换到对应语言的前端页面,或在后台语言编辑器中搜索翻译键,确认是否能找到对应条目。
5. 清除缓存并重新预览
修改文件后,在Shopify主题编辑器中点击刷新按钮,或重新发布主题,避免缓存导致旧内容加载。
内容的提问来源于stack exchange,提问作者Wakil Ahmed
相关产品推荐
相关产品推荐

