Shopify 主题与 Liquid

Shopify section 写了两段 schema 设置全消失

现象#

自定义 section 能加进首页,但编辑器右侧只有名称,所有设置项都不见了;编辑器没有报错,前台也不输出任何内容。

原因#

  • 一个 section 文件只允许存在一个 schema 标签,第二段会被忽略或导致整段解析失败
  • schema 被包在 if 或 HTML 注释里,解析器识别不到标签本身
  • schema 内出现单引号、尾逗号或注释,JSON 校验不通过,设置数组被丢弃
  • 从别的主题复制代码时把整段 schema 一起带过来,与本地定义重复

处理步骤#

  1. 在文件里搜索 {% schema %},确认只有一对且不在任何 Liquid 标签内部
  2. 把两段定义合并成一段,重复的 setting id 只保留一个
  3. 复制花括号之间的内容到 JSON 校验器,修掉尾逗号和中文引号
  4. 运行 shopify theme check --path .,按第一条 schema 报错逐项处理
  5. 保存后刷新编辑器,核对设置项数量与 schema 中定义的数量一致

验收标准#

主题编辑器右侧列出全部设置项,改动任意一项前台立即变化;theme check 对该文件不再报 schema 相关错误。

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