Shopify Online Store 2.0

Shopify theme check 报错太多怎么分优先级处理

现象#

第一次跑 shopify theme check 出现上百条提示,不知道哪些必须改、哪些可以忽略。

原因#

  • 老主题沿用了已废弃标签与过滤器
  • 缺少 .theme-check.yml 配置,默认规则全开
  • 模板里存在未使用的 snippet 与变量
  • 部分规则对多语言主题误报

处理步骤#

  1. 先只处理 Error 级:Liquid 语法、JSON 结构、缺失模板
  2. 生成配置 .theme-check.yml,把 UnusedAssign、MissingTemplate 等按需降级
  3. 按文件批量修:先 templates,再 sections,最后 snippets
  4. 把 theme check 加进提交前脚本,防止新增问题

验收标准#

Error 数为 0,Warning 数量可控并有记录;后续提交不再新增 Error。

专项深读 · 可复现排查指南

可复现的 Theme Check 分级处理示例

不要先关闭所有 Warning。Theme Check 的输出应按语法阻断、运行时风险、维护性问题三个层次分类。先保留原始报告,再在副本主题中逐项修复。

建议按以下顺序复现和定位

  1. 在主题根目录确认当前 Shopify CLI 版本;先生成并审查主题规则配置。
  2. 运行 Theme Check,按文件路径整理 Error、Warning 及命中的规则名称。
  3. 优先处理 Liquid 语法、JSON/schema 结构与找不到模板等实际阻断,再处理废弃接口和性能警告。
  4. 只有在确认误报且有解释时才按规则或文件局部禁用检查,不要全局屏蔽。
  5. 同一命令复跑,记录修复前后差异并把检查集成到提交或发布流程。

可参考的示例(非真实客户环境)

# 在 Shopify 主题根目录(示例命令)
shopify version
shopify theme check --init
shopify theme check

# 有报错时:记录规则名、文件路径和行号
# 修改后重新运行 shopify theme check 并比对结果
注意:规则名、严重等级和配置语法可能随 Theme Check 版本变化,务必使用当前版本的规则文档。不要以“把所有错误改成 Warning”为优化成果。

交付与验证记录应该包含什么

验收记录包含:执行命令、CLI 版本、原始告警列表、实际修复文件、再次检查结果。仍保留的警告应写明原因和影响。

原始技术资料:Shopify / Google 官方文档。本节为根据公开文档整理的排查方法与模拟示例,未宣称来自客户项目或已在您的店铺实测。

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