Shopify CLI 与 Headless

Shopify CLI 升级后命令报错怎么回退

现象#

升级 CLI 后 shopify theme dev 报未知参数,或 app 命令行为变化。

原因#

  • 全局安装了旧版与新版本共存
  • Node 版本不满足新 CLI 要求
  • 项目依赖里锁定了旧版 @shopify/cli

处理步骤#

  1. 检查 which shopify 与 shopify version
  2. 改用项目内依赖:npx shopify ... 或 npm run shopify
  3. Node 升到 CLI 要求的 LTS 版本
  4. 回退用 npm i -g @shopify/cli@x.y.z 并锁定版本

验收标准#

命令行为与文档一致,团队版本统一,CI 与本地结果相同。

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