Shopify section 写了两段 schema 设置全消失
现象#
自定义 section 能加进首页,但编辑器右侧只有名称,所有设置项都不见了;编辑器没有报错,前台也不输出任何内容。
原因#
- 一个 section 文件只允许存在一个 schema 标签,第二段会被忽略或导致整段解析失败
- schema 被包在 if 或 HTML 注释里,解析器识别不到标签本身
- schema 内出现单引号、尾逗号或注释,JSON 校验不通过,设置数组被丢弃
- 从别的主题复制代码时把整段 schema 一起带过来,与本地定义重复
处理步骤#
- 在文件里搜索
{% schema %},确认只有一对且不在任何 Liquid 标签内部 - 把两段定义合并成一段,重复的 setting id 只保留一个
- 复制花括号之间的内容到 JSON 校验器,修掉尾逗号和中文引号
- 运行
shopify theme check --path .,按第一条 schema 报错逐项处理 - 保存后刷新编辑器,核对设置项数量与 schema 中定义的数量一致
验收标准#
主题编辑器右侧列出全部设置项,改动任意一项前台立即变化;theme check 对该文件不再报 schema 相关错误。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。