Shopify Online Store 2.0
Online Store 2.0 把模板从 Liquid 文件换成了 JSON 结构，section schema 的 enabled_on、disabled_on、presets 决定了商家在编辑器里能看到什么、能改什么。这里的文章针对模板保存失败、区块不显示、预设名称对不上语言等典型问题给出配置级的原因分析与修正写法。
-
01
改了 404 模板前台却始终看不到 404 页面
把 404 模板文案换成自定义内容后，访问一个不存在的地址却被跳到首页或某个集合页，怎么改都看不到 404。
-
02
主题编辑器里应用区块提示应用未提供怎么办
首页某段位置在编辑器里显示一块灰色占位并提示该区块不可用，前台这块内容直接消失……
-
03
App embed 无法排在 section 之间是什么原因
主题设置里的 App embeds 开关顺序调了几次，前台脚本位置没变……
-
04
区块缺少 shopify_attributes 后编辑器点不中
在预览区点击某个自定义区块毫无反应，侧栏无法定位到它，拖动排序时高亮落在整个 section 上而不是区块。
-
05
主题缺少 cart.json 导致购物车页面打不开
点页头购物车图标跳到 /cart 返回 404，或只渲染出一个空白页；主题目录里只有 cart.liquid……
-
06
Shopify disabled_on 配错模板类型不生效
配置了 disabled_on 仍能在禁用模板里插入该 section，或反过来：以为禁用了 cart 模板……
-
07
动态源绑定图片后前台 image_url 输出为空
把图片设置连到 file_reference metafield……
-
08
商品 metafield 不出现在动态源下拉列表里
商品已填好自定义字段，在编辑器点某个文本设置的「连接动态源」，列表里只有商品标题、描述……
-
09
复制模板段落时 section id 重复只渲染一个
把一段 section 配置复制成两份贴进 templates/page.landing.json……
-
10
JSON 模板 order 漏写 section 导致整段内容空白
在 templates/index.json 里加了一个 section，编辑器左侧栏能看到它并被选中……
-
11
Shopify JSON 模板 presets 名称对不上语言
主题英文 presets 名称在中文商家后台显示成键名或英文原文，和翻译包对不上；或商家语言切换后……
-
12
section 改了 schema 的 id 后模板里的设置全丢
把 section schema 中的 "id": "heading" 改名成 title 并保存……
-
13
Shopify JSON 模板里改 settings 前台没变化怎么办
直接修改 templates/product.json 里的 settings 值并推送成功，刷新前台还是旧内容……
-
14
Shopify JSON 模板尾逗号导致无法保存
在线商店编辑器或代码编辑器保存 JSON 模板（如 templates/product.json）时提示 inval……
-
15
layout 漏了 content_for_layout 后页面只剩页头
换过 layout 后所有页面只剩页头和页脚，商品、集合、文章正文全部不见，编辑器预览区一片空白但控制台没有报错。
-
16
Shopify 备用模板命名对了却在后台选不到
建了 product.preorder.json，商品编辑页的「主题模板」下拉里没有 preorder 选项。
-
17
Shopify section 里 @app 类型 block 数量受限怎么处理
想在同一个 section 里放 3 个应用 block，编辑器只允许添加一个，或提示该类型不可重复。
-
18
Shopify JSON 模板里加 app block 后提示 schema 无效
手工在 JSON 模板的 blocks 里写了一个 type: "shopify://apps/xxx/blocks……
-
19
Shopify 编辑器拖动 block 顺序后保存丢失
在编辑器里把两个 block 上下拖动，保存刷新后顺序又回到原样，或者内容跑到别的 block 里。
-
20
Shopify section 自定义 CSS 设置怎么写才安全
给 section 加了 custom_css 设置让商家自己写样式，结果一处写错影响全站按钮。
-
21
Shopify 模板 JSON 报 Invalid JSON 但看不出错在哪
复制了一段配置进 JSON 模板，保存提示 Invalid JSON，肉眼检查括号引号都正常。
-
22
Shopify 用 metafield 指定商品模板不生效怎么排查
给商品写了 theme.template metafield 指向备用模板，前台仍渲染默认模板。
-
23
Shopify section group 里页头设置改了不生效
在编辑器里改 sections/header-group.json 对应的页头设置，保存成功但前台没变化……
-
24
Shopify section 设置项太多导致编辑器卡顿怎么办
一个 section 有 60 多个设置，编辑器打开要好几秒，拖动时明显掉帧，商家抱怨改不动。
-
25
Shopify Section Rendering API 返回空内容怎么查
用 ?sections=main-product 请求局部刷新……
-
26
Shopify 静态 section 和 JSON section 混用导致设置丢失
同一个 section 在首页能改设置，在商品页却只有默认值；换模板后原来的配置全没了。
-
27
Shopify theme check 报错太多怎么分优先级处理
第一次跑 shopify theme check 出现上百条提示，不知道哪些必须改、哪些可以忽略。
-
28
Shopify 主题升级 OS 2.0 后旧页面 404 怎么办
换成支持 Online Store 2.0 的新主题后，博客、集合、自定义页面点进去是 404，或者只显示页头页脚……
-
29
新建 page.faq.json 后页面还是走默认模板
在 templates 里加了 page.faq.json……
-
30
product 备用模板改了没反应是没绑到商品上
编辑 product.preorder.json 保存成功，打开任意商品前台仍是默认商品页，新加的区块一个都没出现。
-
31
区块 type 没在 section schema 声明导致不输出
模板 JSON 的 blocks 里写了 "type": "richtext"，前台这段文字完全不出现……
-
32
改 section 没反应？enabled_on 配置排查
在主题编辑器想把某 section 加到首页，列表里根本看不到；或加到商品页后提示不支持。
-
33
section 的 limit 写成 3 后编辑器仍能加第四个
想让某个 section 在一页最多放三次，在 schema 里写了 "limit": 3……
-
34
Shopify section 设置了 max_blocks 却不生效
schema 里写了 max_blocks: 3，编辑器仍能继续添加第 4、第 5 个区块。
-
35
section 预设里配了 blocks 添加出来却是空的
在 presets 中写了三个 slide 区块，商家从「添加 section」插入后侧栏一个区块都没有……
-
36
Shopify Section 没有 presets 导致编辑器加不了怎么办
新写的 section 文件已上传，但在主题编辑器点「添加分区」时列表里找不到它……
-
37
range 的 default 写成字符串导致滑块停在最左端
给 range 设置写了 "default": "40"，编辑器滑块停在最小值，前台间距变成 0……
-
38
templates 里 liquid 与 json 同名模板只能留一个
主题里 product.liquid 与 product.json 同时存在，改 json 保存成功但前台毫无变化……
-
39
两人同时改同一个 section 后改动被覆盖
同事在主题编辑器调完首页 banner 保存，另一人稍后保存自己那版，前者的文案和图片全部回退……
-
40
shopify theme pull 后本地文件和线上不一致
执行 shopify theme pull 后打开本地 templates/index.json……
