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

Shopify 本地开发到底怎么搞?我用 App CLI 搞了一天没跑起来,气死了

Viewed 594

看文档说要装 Node、Ruby、还要搞 ngrok……结果 npm install 报错,然后 ngrok 免费版只能随机域名,
每次都要改 shopify 后台的 whitelist,烦死。想问下现在做本地开发最稳的流程是啥?
是必须用 Remix 吗?我只会 React 能搞不?

4 Answers

我懂你这种慌,因为我也踩过这个坑。其实不用把本地开发想得太复杂。基础流程就几步:
先装 Shopify CLI(用 Homebrew 或 npm 全局装),然后 shopify app init 选 Remix(React 能跑,放心),初始化后直接 npm run dev 就能在 localhost 起服务。然后 shopify app tunnel start 会帮你生成一个 ngrok 地址,把它复制到 Partner Dashboard 的 App URL 配好就行。
每次改代码,ngrok 地址不会变(免费版只要你不重启 tunnel 进程)。唯一烦的是 npm install 慢,建议用 cnpm 或者 pnpm,快很多。
你只配一次后台就能一直用。我第一次搞也用了 4 个小时,第二次 15 分钟。

宝藏回答,求更多

楼上说得对一半,但也没完全对。官方推荐 Remix 是因为它和 Shopify 的 GraphQL 深度绑定了,路由、session、proxy 全帮你封装好,你写个 React 组件就行。我自己试过用纯 Next.js + Shopify Storefront API 搭过,确实也能跑,但你要手动处理 cookie、OAuth 回调、跨域,那叫一个酸爽。
不过你那个 ngrok 的问题,2026 年已经有好几个替代方案了,比如用 Cloudflare Tunnel,免费而且域名固定,一次配置再也不用改 whitelist。我自己从 2023 年踩到 2025 年,终于换了 Tunnel,省了 80% 的头疼事。
另外,新手别碰 Ruby 那套主题开发了,现在 Shopify 官方都在推 App+Theme 分离。你只要 Node 和 React 够熟,用 CLI 初始化 Remix app 后,本地跑 npm run dev 就行,ngrok 加个 --domain 参数可以固定子域名。记住:最开始 shopify app init 时 App Name 别带空格和中文,不然 npm 报错你查半天。

建议直接 GP,谢谢分享

其实你想反了,老哥。Shopify 本地开发真正烦人的不是 CLI 命令,是你得同时维护两套环境:本地的 npm run dev 和 Partner Dashboard 里的配置,一不对应就报 403。
我的建议是:别一开始就搞本地跑全栈,先写一个最简单的 GraphQL 查询(比如查订单数),在 Shopify.dev 的 playground 里跑通,再移植到本地代码里。这样定位问题快,不用被 ngrok 和 OAuth 来回折腾。
另外,2026 年 Shopify 推出了 shopify app env pull 命令,能把远程的环境变量拉到本地,省去手动配的步骤。我自己 5 月用这个命令后,本地搭建从 2 小时缩到 20 分钟。你可以试试。

海运慢船最近又延误

我也亏过,兄弟。去年 12 月接了个单子,客户让我做个自定义 checkout 逻辑,我本地搭了三天环境,最后发现 Shopify 的 checkout extensibility 根本不让本地跑,必须部署到 Partner Dashboard 的 extension 里测。气到我想删库跑路。
后来我发现,如果只是写个简单的 App(比如同步库存、发邮件),直接上 Shopify.dev 的在线 IDE 也能凑合,不用折腾本地。但要是做复杂功能(比如自定义前端组件、后台批量处理),本地开发逃不掉。我的经验是:先确定你要做什么,再决定搭不搭本地环境。别像我一样兴冲冲装了一堆包,最后发现用不上。
哦对了,2026 年 Shopify 的 CLI 3.x 版本已经比 2.x 稳很多了,Setup Wizard 一步到位。但你还是得装 Node 18+、Git 和 npm。别用旧版 Node,我一个朋友用 Node 16 跑,npm install 直接报依赖冲突挂了。

感谢老师,受益匪浅

关于 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