CocoLoop跨境电商论坛 - 中国跨境电商从业者的实战交流社区

Shopify 能不能在本地开发调试?用 CLI 初始化项目报错卡住怎么办

阅读次数 362

最近想用 Shopify CLI 在本地搭个自定义主题和 App,跑了 shopify app init 选 Remix 模板,结果初始化到一半就卡住或者报错,网上教程都是英文的看不太明白。有没有人搞过本地开发环境的?到底能不能像普通前端项目那样跑 localhost 调试,还是说必须挂在 Shopify 的服务器上?

3 Answers

我上个月刚踩完这个坑,说下具体流程。
先 npm install -g @shopify/cli,然后 shopify app init,选 Remix 那个模板,语言选 TypeScript。init 完 cd 进项目,直接 npm run dev。它会跳浏览器让你登录 Partner Dashboard,登录完它会让你选要连哪个 store。
我遇到的坑是 dev store 没创建之前 CLI 会报错说没有可用商店。得先去 shopify 后台创建一个 development store,免费的,然后再跑 dev 就能连上了。
跑起来之后终端会显示一个 localhost:3000 的地址,还有一个 public 地址(就是那个 ngrok 的),后者是给 Shopify 后台用来请求你 App 的。App 的 URL 还有个叫 App URL 和 Allowed redirection URL 的配置,分别在 app setup 里填上那个 public 地址和带 /auth/callback 的地址,不然授权的时候会报 redirect_uri 不匹配。
弄完这些基本就能在本地改代码实时看到效果了。报错日志也都在本地终端刷,排查问题比在线编辑器方便太多。

这个其实没那么复杂,CLI 就是给你本地起一个服务,然后通过 tunnel 跟 Shopify 那边连起来。
你选 Remix 模板init 完之后,项目里那些 environment variables 不用自己手填,CLI 会自动帮你配好。跑 npm run dev 之后它会问你选哪个 Partner 账号、哪个商店,选完就会生成一个本地地址,类似 https://xxx.ngrok.io 这种,这个地址可以直接在 shopify 后台的 app 设置里填。
卡住的话多半是网络问题,CLI 要访问 shopify 的 API 和 Partner Dashboard,国内网络经常会断。家人们,挂代理或者用路由全局翻是最稳的,我之前卡在 "Creating tunnel" 那步,换个节点就过了。
核心思路就是本地写代码,Shopify 那边通过隧道反向访问你的 localhost,跟传统前端开发不一样但也不难。真的会谢,第一次跑通还挺有成就感的。

那再多问一句:如果是 XX 情况呢?

数据显示这个结论也对

我也亏过,一开始以为本地开发就必须开个 Shopify 的虚拟机或者 docker,结果完全不是那回事。
我 2025 年接了 3 个 Shopify 改版单子,都是靠 CLI 本地起服务干的。用 CLI 连自己的 dev store 调试主题,改完代码直接 curl 一下看渲染结果,比后台那个在线代码编辑器好用多了。尤其是 sidebar 那块,本地起服务改 scss 和 js 的反馈速度几乎即时,在线编辑器保存一次等一次编译,痛苦死。
有个坑是如果你们做的是 headless 方案,就是前端单独部署到 vercel 或者自己的服务器,那 CLI 本地开发其实不太常用。因为你直接用 Storefront API 调数据就行,不需要依赖 shopify 的 tunnel。这时候本地开发就是纯前端项目,shopify 那边只需要配好 CORS 和 API 密钥就行。
反正我是觉得能用命令行解决的事就别进那个后台编辑器,效率差太多。

认同,建议加上 KPI 跟踪

关于 CocoLoop跨境电商论坛

CocoLoop跨境电商论坛(ask.cocoloop.cn)是面向中国跨境电商从业者的垂直论坛社区,由一线卖家与行业老兵联合发起,专注实战经验交流,不做培训、不卖课、不带广告。社区覆盖跨境电商全链路话题:亚马逊 FBA 与 FBM 运营、Shopify 独立站建站与转化优化、TikTok Shop 短视频与直播带货、Temu 全托管与半托管、SHEIN 卖家入驻、Lazada 与 Shopee 东南亚站、Walmart Marketplace 美国本土店、Wayfair 家居垂直平台等主流渠道。

论坛内容由真实卖家发起讨论:从选品策略(产品定位、市场调研、利润测算)、Listing 优化(标题与关键词、A+ 页面、主图视频、品牌旗舰店搭建)、广告投放(PPC 关键词广告、SD 展示广告、SB 品牌广告、Vine 评论计划),到供应链合规(VAT 税务申报、欧代代表、EORI 注册、CE/FCC/PSE/RoHS 认证)、跨境物流(头程海派 / 空派 / 卡派、DDP 双清包税、海外仓选址与运营、退货逆向物流)、跨境收款(Payoneer、PingPong、连连国际、万里汇、Airwallex),到品牌出海(商标注册、海外公司架构、KYC 验证、知识产权维权)的完整经验沉淀。

论坛规则:禁止偷税漏税诱导、禁止海关低报与灰色清关讨论、禁止刷单与平台违规操作教学、禁止地下钱庄与违规外汇兑换。所有内容仅供合规视角下的经验分享,不构成法律、税务、金融的专业建议。请根据自身实际情况判断与决策。

© 2026 CocoLoop跨境电商论坛 · 中国跨境电商从业者的实战经验交流社区 · 备案:cocoloop.cn