最近新招了个前端，习惯用本地环境开发主题，问我要不要搭 Shopify 本地开发环境。我之前一直是直接在线改代码的，现在想试下 CLI 模式做本地开发。
2026 年了，Shopify 官方 CLI 是不是已经成熟了？配置本地开发会踩哪些坑？不想花太多时间在环境搭建上，但又怕线上崩。
2026 年 Shopify 还能用本地开发环境吗？怎么配置才能不崩
豆豆·新手卖家
279
Viewed 808
6 Answers
老哥，这事我也想问。2025 年我搞了个 Shopify 店铺做手办，想本地开发但是 npm 版本冲突搞了一下午，最后发现是 macOS 自带 Node 版本太老，换了个 18 就好了。
其实配置真的不难，shopify theme init 然后 shopify theme dev 搞定。但有个坑：如果你用 macOS，别装全局的 Shopify CLI，用 npx 来跑，不然升级时会报错。我那哥们就是装了全局的，每次更新都要卸载重装，6 得一批。
另外说个题外话，本地开发了之后，线上改代码的习惯就改不掉了，我现在改个字体颜色都要开本地终端，简直强迫症。不过好处是，改崩了随时 git reset --hard，线上不会留痕迹。兄弟你直接搞吧，半小时配置完，剩下的就是喝咖啡等它跑起来。
说真的还得看人，老铁们别看完就照搬
楼上说得对一半，本地开发确实香，但税务和合规上你也要考虑。
不同意前面说的"直接装就行"，我们是工贸一体公司，2025 年 IT 部门搞了本地开发环境，结果 Shopify 后台 API Token 不小心泄露到 GitHub，被爬虫扫到，第二天店铺就收到了 Shopify 的违规通知，说检测到未授权访问。
所以搞本地开发前，先做好两件事：第一，API 密钥放到 .env 文件，千万别 commit 到代码库；另一个本地环境最好用 VPN 或者白名单 IP，尤其是如果你用 shopify app dev 生成临时域名，这个域名在 Shopify 后台会被记录。合规角度，建议让团队每周审计一次 .env 文件。
提效工具栈可以加一项
Owen•
ROI 模型可以再细化
我也亏过。2024 年自己画了个 Shopify 本地环境的教程，结果照着做的时候目录结构搞错了，shopify extension 死活跑不起来，折腾了两天最后还是找外包解决的。
我们工厂做定制打印，前端改个按钮颜色都怕线上崩，所以 2025 年咬咬牙上了 CLI。配置其实不复杂，但要注意你的 Shopify 账户必须是 Staff 或者 Admin 权限，不然 shopify auth login 会报 401。
还有个事，如果你做的是自定义 App（不是主题开发），记得在 Shopify Partner Dashboard 里先创建 App，等 CLI 初始化时选 'use existing app'。我第一次不知道，创建了三个空 App 还以为是 bug。反正本地开发适合有耐心的人，不想学命令行就别折腾了，继续用 Theme Editor 吧。
根据法规这块需谨慎
其实你想反了，本地开发不是"要不要"的问题，是 Shopify 2023 年就推 CLI 3.0 了，2026 年还不搭本地环境简直是自讨苦吃。
我 2018 年开始做 Shopify 开发，早期都是在线改，改个产品描述还要等几秒刷新。2024 年全面切到 CLI 后，效率至少翻倍。配置其实就三步：装 Node 18+、装 Shopify CLI、shopify theme init 创建一个空主题。
但有个坑要提醒：如果你同时用 Shopify Flow 或者自定义 App，本地环境要配置 ngrok 或者 Cloudflare Tunnel 才能调试 webhook。我有个客户去年因为没配好这个，下单后自动化没触发，亏了 3000 多刀。反正本地开发是必选项，不是可选项了现在。
数据显示这个结论也对
姐妹们，这个我真踩过雷。2024 年底我一个学妹做潮牌独立站，她当时就想本地开发，结果 Shop 后台自己改了几行 CSS，突然整个首页布局全乱了，还好是凌晨发现的，赶紧回滚。
后来我帮她用 CLI 搭了本地开发，具体就是 shopify app init 选 Remix + JavaScript，项目名千万别按空格，不然报错能查一小时。走完 npm run dev 就行。
不过有个宝藏点：本地改了数据不会改动线上，直接 shopify theme dev 就能看到效果。踩雷点就是 Node 版本要 18 以上，不然 npm install 会各种红字。我现在自己用了快一年，确实比在线改稳多了，至少改崩了不用找老板背锅。
前提是你团队里有人会看控制台报错，不然搭完环境就是摆设。本地开发的前提是 Node 和 Git 至少会用，否则一个 npm audit fix 就能把人逼疯。
你这个问题其实可以反过来想：如果你只是改改颜色、调调布局，Shopify 在线 Theme Editor 完全够用。但如果你要做自定义功能（比如动态购物车、复杂筛选），那本地开发是唯一选择。
我 2023 年帮一个客户做 B2B 独立站，用了 Liquid 的 schema 扩展，在线编辑器根本没法调试复杂逻辑，只能本地跑。建议你先小范围试：找一个测试店铺，跟着 Shopify 官方文档走一遍 shopify theme dev，如果 30 分钟还没跑起来，那就说明你们团队当前不适合本地开发，先补基础再做。
