Shopify 技术百科 — 风格技术

Shopify 模板提示 block 类型未定义怎么修

Tue, 03 Nov 2026 00:00:00 +0800

把旧主题的 settings_data.json 复制到新主题后前台白屏……本文给出排查顺序与修复写法。模板保存成功、前台正常渲染；编辑器里该 section 的 block 列表不再出现未知……

Shopify 集合页 sort_by 排序不生效怎么修

Tue, 03 Nov 2026 00:00:00 +0800

集合页加了 sort 过滤器，前台顺序没变；从右上角下拉框切到「价格从低到高」时列表也纹丝不动……本文给出排查顺序与修复写法。

content_for_header 重复引入导致脚本翻倍

Tue, 03 Nov 2026 00:00:00 +0800

前台 Network 里 analytics 脚本请求出现两次，加购事件上报数量翻倍……本文给出排查顺序与修复写法。页面源码里该标签生成的脚本块只有一份；Network 中分析脚本单次加载……

Shopify image_tag 不生成 srcset 怎么修

Tue, 03 Nov 2026 00:00:00 +0800

把 img_url 换掉后用 image_tag 输出商品卡，2x 屏幕上图仍发虚……本文给出排查顺序与修复写法。商品卡 img 标签带有 srcset 与 sizes……

Shopify Liquid assign 赋值后变量为空怎么排查

Tue, 03 Nov 2026 00:00:00 +0800

在 section 或模板里 assign 了变量，紧接着输出却是空白；把同样的代码放进 snippet 又有值……本文给出排查顺序与修复写法。

Shopify Liquid case/when 写错导致错乱

Tue, 03 Nov 2026 00:00:00 +0800

按产品类型、模板后缀或元字段分支的模块显示错版：本该走 A 布局却落到 else……本文给出排查顺序与修复写法。目标分支文案与布局正确；未知类型走 else 而非报错……

Shopify Liquid contains 判断字符串和数组时结果不对

Tue, 03 Nov 2026 00:00:00 +0800

用 contains 判断标签或选项时，明明有值却返回 false；数组里判断对象也永远不命中。本文给出排查顺序与修复写法。

Shopify Liquid date 过滤器时间差 8 小时怎么修

Tue, 03 Nov 2026 00:00:00 +0800

订单、博客或评论的时间用 date 格式化后，总比后台看到的少 8 小时，跨零点的订单甚至会显示成前一天。本文给出排查顺序与修复写法。

Shopify Liquid default 过滤器对 false 和 0 不生效

Tue, 03 Nov 2026 00:00:00 +0800

设置项里填了 0 或开关关掉，页面上仍显示默认文案；想让空值走兜底逻辑，结果 0 被替换成了默认值。本文给出排查顺序与修复写法。

Liquid escape 与 strip_html 用反导致乱码

Tue, 03 Nov 2026 00:00:00 +0800

商品描述在详情页要么把 b 标签当成文字显示，要么整段标签消失只剩纯文本；搜索结果摘要里还出现 < 这种双重转义。本文给出排查顺序与修复写法。

Shopify Liquid for 循环未结束怎么排查

Tue, 03 Nov 2026 00:00:00 +0800

集合页、商品推荐或购物车行循环只输出一部分，或直接抛出 for tag was never closed。本文给出排查顺序与修复写法。

Shopify Liquid if 与 endif 不匹配怎么修

Tue, 03 Nov 2026 00:00:00 +0800

主题保存或前台渲染时出现 Liquid syntax error: 'if' tag was never close……本文给出排查顺序与修复写法。

Shopify image_url 加 width 参数后图片反而变模糊

Tue, 03 Nov 2026 00:00:00 +0800

为了优化加载速度给 image_url: width: 600，结果在高分屏上图片明显发虚……本文给出排查顺序与修复写法。DevTools 里图片 currentSrc 在 1x/2x 设备下分别命中不同档位……

Liquid json 过滤器输出到 script 标签里报语法错误

Tue, 03 Nov 2026 00:00:00 +0800

把商品数据用 {{ product | json }} 塞进内联 script……本文给出排查顺序与修复写法。浏览器控制台无语法错误，JSON.parse 能拿到完整对象，商品字段与后台一致。

Shopify Liquid json 输出商品名带引号把脚本截断

Tue, 03 Nov 2026 00:00:00 +0800

把商品数据塞进 script 给前端用，标题带英文双引号或结束标签时，控制台报 Unexpected token……本文给出排查顺序与修复写法。

Liquid 菜单链接输出成绝对地址导致预览站跳到正式站

Tue, 03 Nov 2026 00:00:00 +0800

在主题预览或 theme dev 环境点导航，直接跳到线上正式域名，预览环境的改动完全看不到。本文给出排查顺序与修复写法。在预览链接下点击导航仍停留在预览域，URL 里保留预览参数；正式站导航地址正确。

Shopify Liquid map 取嵌套属性全是空白怎么改

Tue, 03 Nov 2026 00:00:00 +0800

集合页想一次取出所有商品的最低变体价，写了 map: 'variants.first.price'……本文给出排查顺序与修复写法。

Shopify money 过滤器在多币种下金额不对怎么办

Tue, 03 Nov 2026 00:00:00 +0800

切换市场币种后，商品价格仍按本币显示；或者价格少了一位、小数位被吃掉，加购后购物车金额又正常。本文给出排查顺序与修复写法。逐个市场切换后，商品页、集合页、购物车三处金额一致……

Shopify Liquid 嵌套 for 循环里 forloop.index 用错怎么办

Tue, 03 Nov 2026 00:00:00 +0800

双层循环渲染分组列表时，内层编号接着外层往下数；或者想用外层序号拼锚点 id，结果每行都重复。本文给出排查顺序与修复写法。每个分组的内层编号从 1 重新开始；页面中不再出现重复的 HTML id，样式交替正常。

Liquid 循环里嵌套 include 导致内容重复输出

Tue, 03 Nov 2026 00:00:00 +0800

列表里每个商品都渲染了两遍甚至多遍，或者同一段 HTML 在页面里重复出现，删掉一层才正常。本文给出排查顺序与修复写法。页面中每条数据只出现一次，DOM 数量与数据条数一致。

Shopify paginate 翻页后筛选条件丢失怎么处理

Tue, 03 Nov 2026 00:00:00 +0800

集合页加了颜色筛选，点第二页筛选全部重置，或者翻页后仍显示筛选前的商品。本文给出排查顺序与修复写法。带筛选参数点第 2 页，URL、商品列表、筛选选中态三者一致；末页无空白。

Shopify 商品变体超过 100 个时前台只显示一部分

Tue, 03 Nov 2026 00:00:00 +0800

后台商品有 150 个变体，前台变体选择器只出现前 100 个，剩下的客户选不到，加购也无对应 SKU。本文给出排查顺序与修复写法。

Shopify render 的 with 与 for 参数用错导致数据为空

Tue, 03 Nov 2026 00:00:00 +0800

{% render 'card', with: product %} 之后 snippet 里 {{ card }}……本文给出排查顺序与修复写法。

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

Tue, 03 Nov 2026 00:00:00 +0800

改完 section 的 schema 后在编辑器点保存，提示设置无效或整段设置项消失……本文给出排查顺序与修复写法。编辑器能正常保存，设置项全部显示且拖动/选择后前台有响应……

Shopify section 颜色设置输出到 CSS 不生效怎么排查

Tue, 03 Nov 2026 00:00:00 +0800

在 section schema 里加了颜色设置，前台也填了色值，但页面上的按钮颜色始终是默认值……本文给出排查顺序与修复写法。

Shopify sort_natural 中文排序乱序怎么修

Tue, 03 Nov 2026 00:00:00 +0800

品牌列表用 sort_natural 排序后，中文名没有按拼音走，而是「阿」「白」「红」乱跳……本文给出排查顺序与修复写法。

Shopify 主题前台显示 translation missing 怎么修

Tue, 03 Nov 2026 00:00:00 +0800

切换语言后前台出现 translation missing: zh-CN.products.add_to_cart……本文给出排查顺序与修复写法。

Shopify Liquid unless 条件反了怎么排查

Tue, 03 Nov 2026 00:00:00 +0800

本应隐藏的售罄标还在，或会员价区块对未登录用户也露出来。本文给出排查顺序与修复写法。四种边界组合显示与真值表一致；团队文档写明本仓库对 unless 的使用约定。

Shopify Liquid where 多条件筛选为什么只生效一个

Tue, 03 Nov 2026 00:00:00 +0800

集合页写 where: 'available', true, 'product_type', '衬衫'……本文给出排查顺序与修复写法。

Shopify locales 语言文件写错整站文案变 key

Tue, 03 Nov 2026 00:00:00 +0800

改完 zh-CN.json 后刷新中文前台，导航和按钮全变成 general.search 这类键名……本文给出排查顺序与修复写法。