Shopify 报错排障

主题自定义 CSS 报 Invalid CSS 怎么修

现象#

在主题编辑器某个 section 的自定义 CSS 框里粘贴一段带 @media 的样式,输入框下方立刻出现 Invalid CSS,光标移开后代码被清空,保存按钮变灰。

原因#

  • 编辑器内置的 CSS 校验器语法覆盖面比浏览器窄,较新的属性或嵌套写法会被判非法
  • 自定义 CSS 框只接受声明块,直接写 @import、@charset 这类顶层规则会被拒
  • 花括号或分号不配对时,校验器从出错位置起整段丢弃,看起来像全部被清空
  • 把 SCSS 的变量、嵌套与 & 符号混进了纯 CSS 输入框,编译器无法解析

处理步骤#

  1. 先把这段样式贴到 assets/base.css 末尾保存,绕开编辑器输入校验
  2. 再逐段回填:每次只留一个选择器,通过后再加下一段,锁定被拒的那条
  3. 检查 !important 前是否多写了分号,这是最常见的被拒写法
  4. 把嵌套规则展开成扁平选择器,或改用 {% style %} 写进 section 文件
  5. 需要媒体查询时确认 @media 块的括号成对闭合,不要跨块嵌套

验收标准#

该 section 的自定义 CSS 框不再出现红字,保存后前台刷新,目标元素在 375px 与 1440px 两个宽度下样式都生效。

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

把 Invalid CSS 定位为语法还是编辑器限制

先分清 CSS 本身不合法,还是主题编辑器对输入上下文有额外限制。不要为了消除报错把样式无条件追加到全局 base.css,可能造成整站污染。

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

  1. 在浏览器开发者工具里验证 CSS 语法是否能正常解析。
  2. 缩减为一个选择器和一个声明;逐个加回媒体查询、伪类及变量。
  3. 确认输入位置是主题级自定义 CSS 还是 Section 的自定义 CSS,不同位置的支持能力不完全一致。
  4. 如必须使用复杂选择器或媒体查询,考虑由开发者放入主题独立 CSS 资产并限定组件作用域。
  5. 在主题副本中测试 375px、768px 和桌面宽度下的优先级与覆盖关系。

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

.product-info__heading { letter-spacing: .01em; }
@media (max-width: 749px) {
  .product-info__heading { font-size: 1.8rem; }
}
/* 示例:选择器必须按当前主题的真实 DOM 调整 */
注意:Section 级 CSS 可能受作用域和字段长度限制。不要把示例中的 class 当作 Shopify 通用内置类名。

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

保存后查看源样式是否保留;检查桌面与移动端,不出现 CSS 校验错误,也不影响其它产品页面。

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

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