You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.17 01:20:02