JSON 模板 order 漏写 section 导致整段内容空白
现象#
在 templates/index.json 里加了一个 section,编辑器左侧栏能看到它并被选中,右侧预览和前台却完全没有这段内容,其余 section 正常。
原因#
- 模板按
order数组逐个渲染,sections里存在却没写进数组的 id 不会进入渲染队列 - 手工合并两个模板时把
order整体覆盖成对方的值,本地新增的 id 全部丢失 - 编辑器保存会按侧栏顺序重写 order,此前手工写入的顺序被整段替换
- order 里写了 sections 中并不存在的 id 时,该项被静默跳过,界面不提示
处理步骤#
- 打开
templates/index.json,把sections对象的键与order数组逐个对照,列出差集 - 把缺失的 id 追加进
order,字符串与 sections 的键完全一致,注意大小写 - 删掉 order 里多出来的、sections 中不存在的 id,避免渲染阶段被跳过
- 保存后运行
shopify theme check,确认没有模板结构类报错 - 在编辑器里拖动一次该 section 的顺序并保存,让 Shopify 重新生成规范的 order
验收标准#
前台源码能搜到 id="shopify-section-你的id" 容器,且内容出现在拖动后的位置。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。