Shopify 想自己本地开发个 App 玩玩，有没有踩过坑的？走 CLI 初始化总是卡住

这个其实没那么复杂，但官方文档绕了一个弯。
我 2025 年底弄过。那个 CLI 叫 shopify app init，关键是你本机得先装 @shopify/cli 和 @shopify/theme 两个包，装完才能跑初始化。npm install 卡住多半是 node 版本问题，官方推荐 node 18+，我 2024 年用 node 16 干瞪眼半小时。换了 nvm 切到 20 就过了。
还有个小坑：Partner Dashboard 里创建 App 时，Client ID 和 API Secret 那一堆东西，CLI 初始化完后会自己配，你不用手写。但很多教程让人去手动填环境变量，越填越乱。
对了，本地跑起来要 ngrok 隧道，不然 Shopify 回调地址验不过。免费版 ngrok 每次启动地址变，每次改后台挺烦的。我用的是自建 frp，省钱但配置麻烦。
反正开发者体验一般，但能跑通。

楼上说的 Extensions 确实省事，但我试着问一下：你那个 npm install 报错的具体信息是啥？
我 2025 年底也卡过，报错是 ERR! code EINTEGRITY，最后发现是 npm 缓存问题。npm cache clean --force 再重装就好了。如果你也是类似问题，可以试试。但如果是 node-gyp rebuild 报错，那就是本地缺 Python/C++ 编译环境，macOS 要装 Xcode Command Line Tools，Windows 要装 Visual Studio Build Tools。
我这货代出身对这些不熟，折腾了三天才搞定。后来想想，Shopify App 做得再好，物流端跟不上也是白搭。

我懂你这种慌，家人们谁懂啊，我也是第一步就卡住。
2026 年初刚整完，直接给你实操流：先 npm install -g @shopify/cli，再 shopify app init。选择的 Remix 模板那一步，不要选默认的"TypeScript"，选 JavaScript，因为官方 TypeScript 模板有个 bug，类型定义文件缺一个，跑 npm run dev 会一直报找不到模组，真的会谢。
另外他那个 "adaptive-poo"（你输入的项目名）目录下有个 shopify.app.toml 文件，里面 client_id 必须跟 Partner 后台一致。很多人卡在 app init 完就以为好了，直接 npm run dev 然后链不上，就是这个文件没对。
最后自嘲一句，我花了两天把这块搞明白，结果做的 App 上线后月销 30 单，纯属为爱发电。

其实你想反了，宝子们。
本地开发根本不是技术难点，难的是后续的"上架审核"。Shopify App Store 2025 年改了审核规则，要求提供完整的隐私政策、GDPR 合规说明、还有 OAuth 权限范围的逐条解释。我见过好几个 App 本地跑通了，审核挂了三个月。
我自己踩过的雷是权限请求过度，我写的一个"订单打印助手"要了 read_orders 和 write_orders，结果审核被打回来，说必须解释为什么同时要读写权限。改回只读 read_orders + 在 App 里让用户手动确认打印，才过。
所以本地跑通不是终点，建议先研究一下 Shopify App Store 的审核文档，照着它的权限要求去写代码，不然后面改逻辑更头疼。

我也试过，后来放弃了，亏了三天工时。
不推荐用 CLI 本地开发，除非你公司有专门的 DevOps 折腾。我 2023 年找过 Shopify 的技术支持，对方说官方最佳实践是直接在 Shopify 管理后台用 Theme App Extensions 来做，不用本地环境，浏览器里直接写 Liquid 和 JS，零部署，改完即生效。
你想想，本地开发的好处是能调试 UX、复用 Git 工作流。但独立站 App 本身功能有限，大多数是修改主题样式，或者加个弹窗、测个 A/B。用 Extensions 做足够，省掉 ngrok、环境变量、npm 报错这些破事。
长期来看，如果你要做的 App 有后端交互（比如对接外部 ERP），那就必须本地了。不然真的没必要为难自己。