Shopify Online Store 2.0

主题缺少 cart.json 导致购物车页面打不开

现象#

点页头购物车图标跳到 /cart 返回 404,或只渲染出一个空白页;主题目录里只有 cart.liquid,没有 cart.json。

原因#

  • OS 2.0 主题的 /cart 由 templates/cart.json 驱动,缺失时没有可渲染模板
  • cart.json 引用的 section 文件不存在或 type 写错,渲染中断后退回错误页
  • 从旧版本升级时只搬了 sections 目录,没搬 templates 下的 JSON 文件
  • 应用把购物车改成抽屉式后删掉了 cart 模板,直接访问该 URL 就落到 404

处理步骤#

  1. 在 templates/ 下新建 cart.json
  2. 只保留 sections 与 order 两个键,main.type 填真实的购物车 section 文件名
  3. 确认该 section 存在,且内部有购物车表单或 cart 对象输出
  4. 推送后在编辑器打开 Cart 模板,确认可以添加区块
  5. 抽屉与独立购物车页并存时保留 cart.json,供直接访问与无障碍回退

验收标准#

直接访问 /cart 返回 200 并渲染购物车表单,编辑器模板下拉中能看到 Cart。

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