2026 年 Shopify 到底能不能本地开发？用 CLI 之前有哪些坑

我也亏过这上面的时间。之前帮客户做店铺迁移，需要在本地把主题改好再传上去，结果 Shopify CLI 死活连不上那个 store，报什么 theme ID 不匹配。最后查了半天，是客户开了 storefront password，CLI 访问不了，把密码关了就好了。
所以你要是想本地开发，先检查几件事：店铺是不是开了密码保护、CLI 版本是不是最新、tunnel 端口被没被占用。搞 IT 的就懂，大部分问题都是环境问题，不是代码问题。我遇到的最玄学的一次，是公司网络防火墙把 ngrok 的流量拦了，换个网络就好了。
物流那边的系统也是，经常有客户说本地能跑线上就不行，最后发现是环境变量没配全。Shopify 也一样，你把 .env 文件里的 key 都核对一遍，八成能解决。反正别慌，一步步排查，搞不定就去社区搜，这坑很多人都踩过。

说个具体的 case。我去年接了一个客户，说开发了个 Shopify 应用，本地跑得好好的，一部署到生产环境，用户授权就报错。排查半天，发现他本地用了 http://localhost:port 做回调，但 Shopify 要求必须是 https，而且生产环境域名没加到 app 的 allowed URLs 里。
这类问题本质不是"能不能本地开发"，而是你对 Shopify 的 app 配置模型没理解透。本地开发只是把代码跑起来，但外部服务访问你的回调地址，必须通过隧道暴露公网 https 端点。所以你要确保隧道工具稳定，不然每次调试都像开盲盒。
还有一点，本地开发容易忽略 app 的 scopes 权限。本地测试可能用店主账号，权限全开，但真实用户授权时，scope 不够就会静默失败。我建议在本地就模拟多角色，别光用 admin 测。

其实你想反了。问题不在于"能不能本地开发"，而在于"你为什么要本地开发"。如果你只是改改主题颜色、调调布局，Shopify 后台的在线代码编辑器够用了，实时保存实时看，还不用配环境。我团队里新手都是直接线上改，改坏了大不了回滚。
但如果你做的是定制 app，涉及复杂业务逻辑，那本地开发是必须的。因为你得调试、断点、写单元测试，这些在线上环境做不现实。不过别自己搭，直接用官方 Remix 模板，它把 GraphQL 客户端、会话管理、CSRF 防护都集成了，比自己从零写稳得多。
我这边供应链那边有个伙伴，去年自己用 Node 原生写了个 app，没走官方模板，结果 webhook 验签没做对，客户数据收到但验证失败，订单同步全乱了，修了两天才好。所以能站在巨人肩膀上就别自己造轮子。

你这个"能不能本地开发"，我反过来问你一句，你之前做过 Shopify 主题开发还是应用开发？这两个完全是两码事。
主题开发的话，本地搞个 Shopify CLI 连上 store，改 scss 和 liquid 实时预览，这个流程 2024 年就挺成熟了。但应用开发，尤其是嵌到后台的 app block，本地调试比前端复杂得多，要配 scopes、webhook、session storage，我 2021 年刚开始做的时候踩了一周坑才把 OAuth 流程跑通。
现在官方模板确实省事不少，Remix 那个脚手架把 CRUD 和 auth 都生成好了。但别指望零配置，你至少得搞懂 session 怎么存、token 怎么刷新。我个人建议，如果只是给自家店铺用，直接装现成 app 或者写个简单主题功能就够了，别为了"本地开发"这个仪式感把自己绕进去。2026 年了，工具链还是那套东西，没质的飞跃。

楼上那个 CLI 流程写得挺细，但我要泼盆冷水。官方那个 shopify app init 看着简单，实际跑起来各种幺蛾子。我前两周刚折腾了一个新项目，Node 版本不对直接报错，Remix 模板拉下来依赖装完要 20 分钟，然后 auth 回调地址填错，白屏半小时。
本地开发的核心痛点是 tunnel。你本地跑起来了，Shopify 后台要能访问到你 localhost，就得靠 ngrok 或者 cloudflared。免费版 ngrok 每次重启域名都变，你得去 Partner Dashboard 重新配置，烦得要死。我后来直接买了 ngrok 付费版，省心很多。
另外 Windows 用户注意，很多命令在 PowerShell 里跑跟 Mac 不一样，路径空格、权限问题，折腾半天。如果团队协作，环境不一致，光排错就能耗一天。建议先拿个测试 store 练手，别一上来就动生产环境。

这事我也想问呢，家人们。我 2025 年买了一门 Shopify 开发课，老师教得可起劲，结果自己上手，第一步 CLI 安装就卡了半小时。npm 装个包各种权限报错，我 Mac 上搞了半天才发现是 node 版本问题，气的我差点把电脑砸了，真的会谢。
后来我学乖了，直接用官方那个在线 playground 先跑通逻辑，再考虑本地。反正你要是跟我一样不是科班出身，别一上来就挑战最高难度。先把 Shopify 后台那些设置摸清楚，app 怎么装、权限怎么给，这些弄明白了，CLI 那些命令其实就那么回事。
我现在是能线上改就线上改，真要用本地，也得先备份好环境，别到时候折腾坏了还得重装系统，那就真得哭了。朋友们，听我一句劝，循序渐进，别贪快。