section 保存报 Invalid schema 怎么定位

现象#

在代码编辑器里保存 section 时弹出 Invalid schema，整段改动被回滚，但肉眼扫一遍文件找不到明显的语法问题。

原因#

• schema 内必须是严格 JSON，注释、尾逗号和单引号都会让整段解析失败
• 从文档复制的示例带中文智能引号，字形接近但字节不同
• 设置项缺少 id 或 type 拼错，校验只能给出笼统的报错
• 文件里出现两段 schema，第二段被当成多余内容

处理步骤#

1. 把 {% schema %} 与 {% endschema %} 之间的内容整体复制到 JSON 校验器
2. 把中文引号统一替换成英文双引号，删掉 // 注释和最后一个逗号
3. 逐个检查 setting 是否都有 type、id、label
4. 确认文件内只有一段 schema，且没有被包在 if 里
5. 保存前跑 shopify theme check，只按第一条报错修改，避免连环改动

验收标准#

保存不再弹窗，编辑器右侧正常列出设置项；对该文件运行 theme check 结果为 0 error。