Shopify 本地开发到底怎么搞？我看教程说用 CLI 但命令都跑不起来

楼主你这问题我上个月刚碰到，绷不住了。CLI 装完第一次跑确实容易翻车。
说关键的：你先确认你是用 brew 装的 Shopify CLI 还是 npm 全局装的？如果你先装了旧版（2.x），新版 3.x 的命令完全不一样。
我当初就是踩了这个坑，brew install shopify-cli 给我装的 2.x，然后跑 shopify app init 直接报错说找不到。后来卸载用 npm i -g @shopify/cli 重新装了，才正常。
另外你说 npm install 报错，大概率是 Node 版本问题。Shopify CLI 3.x 要求 Node 18 或 20，但你 node -v 看下是不是 18.x 最低版本？我记得 18.0.0 以下有些依赖装不上。
我后来切到 20 LTS 才消停。
还有一个坑：初始化时选 Partner Dashboard 登录，注意别用 Safari 浏览器登录，Chrome 兼容性更好。那个 OAuth 回调在 Safari 下经常白屏，我当时卡了整整一下午没搞明白。

姐妹们听我说一个宝藏路径，不用 CLI，直接手动搭也挺香。
我一开始也是被 CLI 搞破防了，npm install 动不动报 peer dependency 冲突。后来我看了 Shopify 官方文档的"Build a custom app"部分，发现直接创建一个 Express 后端 + 前端用 Remix 自己搭，反而可控很多。
你只需要在 Partner Dashboard 里新建一个 Application，拿到 API Key 和 Secret，然后在本地用 Shopify OAuth 流程手动对接。虽然多敲几行代码，但整个链路你心里有数，踩雷概率比 CLI 魔改低。
踩雷坑：手动搭的话一定要严格按官方的 OAuth 回调 URL 格式来，我之前把 redirect_uri 写成了 http://localhost:3000/callback 但没带 /oauth 路径里的参数拼接，结果每次跳转都 403。
改好后一次过，再也没碰 CLI 了。

这事我也想问，本来好好的 npm run dev 能跑起来，结果 2026 年初 Shopify CLI 更新了一版，我这边的项目直接崩了。
楼上说的客户端类型确实关键。我自己开发了三四个月，总结下来最稳的路径是先别用 brew，直接用 npm 全局装 @shopify/cli@latest，然后 node -v 确保是 20.x 以上。
初始化时选 JavaScript 别选 TypeScript，TS 配置太严格，新手容易在 tsconfig 报错上磨半天，JS 跑通后再慢慢加类型包。
另外有个隐藏坑：初始化成功后，项目里会生成一个 .env 文件，里面包含 Partner Dashboard 的 API Key。你本地跑 dev 时要确保 .env 没被 .gitignore 掉。
我第一次把 .env 加了 gitignore，结果项目推到 GitHub 再拉下来，本地环境死活验证不过，折腾了两天才发现是 api key 丢了。