Shopify 报错排障

改主题后全站样式丢失怎么恢复

现象#

改完 theme.liquid 或上传新样式后,前台变成无样式纯文本,图片也不显示。

原因#

  • 样式表引用路径被改错,或 asset_url 拼写错误
  • 把 {{ content_for_header }} 删掉了,Shopify 注入的资源失效
  • CSS 文件本身语法错误(少一个右括号),浏览器整份丢弃
  • 上传时文件名大小写变化,Linux CDN 区分大小写

处理步骤#

  1. 查看页面源码,确认 <link rel="stylesheet"> 的 URL 能直接打开
  2. 检查 <head> 是否保留 {{ content_for_header }}
  3. 用 CSS 校验工具检查括号与转义,修复后重新上传
  4. 回滚到上一个主题版本对比差异(主题支持历史版本回退)

验收标准#

前台样式恢复;所有静态资源返回 200,无 404 请求。

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