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 文件缺失时回退英文
处理步骤#
- 在
locales/en.default.schema.json里补sections.hero.name的值 - 把 schema 的 label 改成
t:sections.hero.name,冒号后不要留空格 - 需要多语言时补
locales/fr.schema.json,结构与默认文件保持一致 - 重启
shopify theme dev,locale 文件改动不会热更新到编辑器 - 在编辑器里重新打开该 section 的设置面板,确认显示真实名称
验收标准#
编辑器侧栏与设置面板都显示「首屏横幅」而不是 key 字符串;切到法语后显示对应译文。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。