看文档说要装 Node、Ruby、还要搞 ngrok……结果 npm install 报错,然后 ngrok 免费版只能随机域名,
每次都要改 shopify 后台的 whitelist,烦死。想问下现在做本地开发最稳的流程是啥?
是必须用 Remix 吗?我只会 React 能搞不?
看文档说要装 Node、Ruby、还要搞 ngrok……结果 npm install 报错,然后 ngrok 免费版只能随机域名,
每次都要改 shopify 后台的 whitelist,烦死。想问下现在做本地开发最稳的流程是啥?
是必须用 Remix 吗?我只会 React 能搞不?
我懂你这种慌,因为我也踩过这个坑。其实不用把本地开发想得太复杂。基础流程就几步:
先装 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跨境电商论坛(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