Shopify 市场与本地化

section schema 里 t: 开头的中文名不显示怎么修

现象#

新写的 hero section 在 schema 里写 label: t:sections.hero.name,主题编辑器左侧直接显示 t:sections.hero.name,前台设置面板也是这串字符。

原因#

  • t: 前缀只在 .schema.json 里查 key,不会去读 en.default.json
  • key 要与文件里的层级完全一致,少一层 sections 就查不到
  • 在 schema 里写 {{ 'x' | t }} 不会被求值,会原样当字面量输出
  • 只加了 en.default.schema.json,其它语言的 schema 文件缺失时回退英文

处理步骤#

  1. 在 locales/en.default.schema.json 里补 sections.hero.name 的值
  2. 把 schema 的 label 改成 t:sections.hero.name,冒号后不要留空格
  3. 需要多语言时补 locales/fr.schema.json,结构与默认文件保持一致
  4. 重启 shopify theme dev,locale 文件改动不会热更新到编辑器
  5. 在编辑器里重新打开该 section 的设置面板,确认显示真实名称

验收标准#

编辑器侧栏与设置面板都显示「首屏横幅」而不是 key 字符串;切到法语后显示对应译文。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。