Shopify 主题与 Liquid

Shopify section schema 设置类型写错导致保存失败

现象#

改完 section 的 schema 后在编辑器点保存,提示设置无效或整段设置项消失,控制台报 schema 校验错误。

原因#

  • type 用了不存在的类型,如 text_area、color_picker
  • range 类型的 min / max / step 不是数字或缺失
  • select 的 options 写成了字符串数组而不是 {value,label} 对象
  • 同一个 section 里 id 重复,或 id 里带了大写字母与短横线以外的字符

处理步骤#

  1. 对照官方 schema 文档逐个核对类型名:text、textarea、richtext、range、select、color、image_picker、url、checkbox
  2. select 的 options 改成 [{'value':'a','label':'选项 A'}]
  3. range 补齐三个数值字段,step 不要写成字符串
  4. 跑 shopify theme check,ValidSchema 规则会直接指出行号
  5. 改完先 shopify theme push --only sections/xxx.liquid 单文件推送,避免整站覆盖

验收标准#

编辑器能正常保存,设置项全部显示且拖动/选择后前台有响应,theme check 无 ValidSchema 报错。

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