Shopify 主题与 Liquid
Liquid 是 Shopify 主题的模板语言，报错几乎都落在标签闭合、变量作用域与对象层级这三处。本分类整理 for、if、case、unless 等标签写错时的具体报错文案、定位路径与修复写法，并说明主题编辑器里改完不生效时的检查顺序，帮你在上传主题前就把问题拦住。
-
01
Shopify 模板提示 block 类型未定义怎么修
把旧主题的 settings_data.json 复制到新主题后前台白屏……
-
02
Shopify 集合页 sort_by 排序不生效怎么修
集合页加了 sort 过滤器，前台顺序没变；从右上角下拉框切到「价格从低到高」时列表也纹丝不动……
-
03
content_for_header 重复引入导致脚本翻倍
前台 Network 里 analytics 脚本请求出现两次，加购事件上报数量翻倍……
-
04
Shopify image_tag 不生成 srcset 怎么修
把 img_url 换掉后用 image_tag 输出商品卡，2x 屏幕上图仍发虚……
-
05
Shopify Liquid assign 赋值后变量为空怎么排查
在 section 或模板里 assign 了变量，紧接着输出却是空白；把同样的代码放进 snippet 又有值……
-
06
Shopify Liquid case/when 写错导致错乱
按产品类型、模板后缀或元字段分支的模块显示错版：本该走 A 布局却落到 else……
-
07
Shopify Liquid contains 判断字符串和数组时结果不对
用 contains 判断标签或选项时，明明有值却返回 false；数组里判断对象也永远不命中。
-
08
Shopify Liquid date 过滤器时间差 8 小时怎么修
订单、博客或评论的时间用 date 格式化后，总比后台看到的少 8 小时，跨零点的订单甚至会显示成前一天。
-
09
Shopify Liquid default 过滤器对 false 和 0 不生效
设置项里填了 0 或开关关掉，页面上仍显示默认文案；想让空值走兜底逻辑，结果 0 被替换成了默认值。
-
10
Liquid escape 与 strip_html 用反导致乱码
商品描述在详情页要么把 b 标签当成文字显示，要么整段标签消失只剩纯文本；搜索结果摘要里还出现 < 这种双重转义。
-
11
Shopify Liquid for 循环未结束怎么排查
集合页、商品推荐或购物车行循环只输出一部分，或直接抛出 for tag was never closed。
-
12
Shopify Liquid if 与 endif 不匹配怎么修
主题保存或前台渲染时出现 Liquid syntax error: 'if' tag was never close……
-
13
Shopify image_url 加 width 参数后图片反而变模糊
为了优化加载速度给 image_url: width: 600，结果在高分屏上图片明显发虚……
-
14
Liquid json 过滤器输出到 script 标签里报语法错误
把商品数据用 {{ product | json }} 塞进内联 script……
-
15
Shopify Liquid json 输出商品名带引号把脚本截断
把商品数据塞进 script 给前端用，标题带英文双引号或结束标签时，控制台报 Unexpected token……
-
16
Liquid 菜单链接输出成绝对地址导致预览站跳到正式站
在主题预览或 theme dev 环境点导航，直接跳到线上正式域名，预览环境的改动完全看不到。
-
17
Shopify Liquid map 取嵌套属性全是空白怎么改
集合页想一次取出所有商品的最低变体价，写了 map: 'variants.first.price'……
-
18
Shopify money 过滤器在多币种下金额不对怎么办
切换市场币种后，商品价格仍按本币显示；或者价格少了一位、小数位被吃掉，加购后购物车金额又正常。
-
19
Shopify Liquid 嵌套 for 循环里 forloop.index 用错怎么办
双层循环渲染分组列表时，内层编号接着外层往下数；或者想用外层序号拼锚点 id，结果每行都重复。
-
20
Liquid 循环里嵌套 include 导致内容重复输出
列表里每个商品都渲染了两遍甚至多遍，或者同一段 HTML 在页面里重复出现，删掉一层才正常。
-
21
Shopify paginate 翻页后筛选条件丢失怎么处理
集合页加了颜色筛选，点第二页筛选全部重置，或者翻页后仍显示筛选前的商品。
-
22
Shopify 商品变体超过 100 个时前台只显示一部分
后台商品有 150 个变体，前台变体选择器只出现前 100 个，剩下的客户选不到，加购也无对应 SKU。
-
23
Shopify render 的 with 与 for 参数用错导致数据为空
{% render 'card', with: product %} 之后 snippet 里 {{ card }}……
-
24
Shopify section schema 设置类型写错导致保存失败
改完 section 的 schema 后在编辑器点保存，提示设置无效或整段设置项消失……
-
25
Shopify section 颜色设置输出到 CSS 不生效怎么排查
在 section schema 里加了颜色设置，前台也填了色值，但页面上的按钮颜色始终是默认值……
-
26
Shopify sort_natural 中文排序乱序怎么修
品牌列表用 sort_natural 排序后，中文名没有按拼音走，而是「阿」「白」「红」乱跳……
-
27
Shopify 主题前台显示 translation missing 怎么修
切换语言后前台出现 translation missing: zh-CN.products.add_to_cart……
-
28
Shopify Liquid unless 条件反了怎么排查
本应隐藏的售罄标还在，或会员价区块对未登录用户也露出来。
-
29
Shopify Liquid where 多条件筛选为什么只生效一个
集合页写 where: 'available', true, 'product_type', '衬衫'……
-
30
Shopify locales 语言文件写错整站文案变 key
改完 zh-CN.json 后刷新中文前台，导航和按钮全变成 general.search 这类键名……
-
31
Shopify paginate 套在 for 里第二页空白
首页按系列分组展示商品，paginate 写在遍历 collections 的 for 内部……
-
32
Shopify presets 与 default 哪个优先级更高
给设置写了 default，从「添加分区」插入同一个 section 后文本却是空的……
-
33
Shopify render 与 include 变量隔离的区别
把旧主题的 include 'price' 改成 render 'price' 后……
-
34
Shopify request.page_type 判断页面失效
在 theme.liquid 里用 request.page_type 判断商品页来加载脚本，结果商品页没加载……
-
35
Shopify routes 对象写错导致站内链接 404
导航里的「全部商品」点进去是 404，链接显示成 /collections// 或 /collectionsunde……
-
36
Shopify section 写了两段 schema 设置全消失
自定义 section 能加进首页，但编辑器右侧只有名称，所有设置项都不见了；编辑器没有报错，前台也不输出任何内容。
-
37
section 保存报 Invalid schema 怎么定位
在代码编辑器里保存 section 时弹出 Invalid schema，整段改动被回滚……
-
38
Shopify 报 Setting type 无效怎么改类型
给 section 加了一个下拉框，schema 里写 type 为 dropdown……
-
39
snippet 里取 section.settings 为空怎么办
在 section 里 render 一个徽章片段……
-
40
Shopify stylesheet_tag 顺序放错样式被覆盖
自定义样式写进 custom.css 并在 theme.liquid 引入，前台按钮颜色仍是主题默认值……
