以前都是直接在 Shopify 后台改主题,最近想正经做 App 开发,看官方推荐用 CLI 初始化 Remix 项目。
但我本地跑起来总报错,Node 版本也换了好几轮。想问问真有人用这套本地开发流程吗?还是我姿势不对?
以前都是直接在 Shopify 后台改主题,最近想正经做 App 开发,看官方推荐用 CLI 初始化 Remix 项目。
但我本地跑起来总报错,Node 版本也换了好几轮。想问问真有人用这套本地开发流程吗?还是我姿势不对?
楼主你问这问题就有点绷不住,官方文档写得跟相亲简历似的,看着都行,一跑全露馅。
我直接说结论:CLI 那套能用,但别指望它给你省心。我上个月刚折腾完,核心就这么几个事:Node 别用 22,用 20 LTS;装完依赖先跑一遍 shopify app dev,它帮你处理 tunnel 和端口,比你自己 ngrok 省事;还有那个 Partner Dashboard 的 API key 记得提前建好,别等初始化卡那儿再翻邮箱。
对了,你要是用 Windows,建议直接放弃,WSL2 里跑吧,不然那个文件监听能让你怀疑人生。就这样,祝你好运。
楼上说的对一半,Node 版本确实是大坑,但我的观点可能不太一样:如果你不是做 App 而是只想搞主题开发,那套 Remix CLI 根本没必要碰。
从财税和合规角度多说一句,本地开发本身没问题,但你用 Partner Dashboard 创建 App 时,填的 OAuth redirect URL 如果能用本地 HTTPS 隧道,入库数据可能涉及客户信息,别忘了一块儿过两遍你们自己公司的数据处理规范。
我团队现在是这样处理的:开发环境用 Shopify CLI 的 --tunnel 参数直接起,不走第三方;生产环境的 App 再单独部署到 Vercel 或者 Fly.io,环境变量分开管理。这套流程从 2024 年用到现在,出过两次问题,但都是权限没配好,跟本地开发没关系。
你要真想入坑,建议先把自己的业务场景写清楚,是做嵌入式 App 还是纯后台扩展,这俩的权限模型不一样,后面亏过的地方也不一样。
建议提前咨询专业人士
这条我得收藏
我也亏过,真的会谢。去年 12 月我按教程走 shopify app init,选 Remix + JavaScript,前面一路绿灯,结果 cd 进项目目录跑 npm run dev,直接给我报个 WebAssembly 相关的错,查了半天是 Node 版本太新,官方那套依赖还没跟上。
后来我学乖了,装了个 nvm 锁在 18.x LTS,才跑起来。
说几个我踩过的点吧:
首先别用最新版 Node,锁 LTS,2026 年这会儿 20 和 22 都有兼容问题。还有初始化时项目名千万别带空格,我同事写了个 "my app" 直接凉了半截。另外一个本地跑起来之后要开 tunnel,我用的是 ngrok,免费的够测试用。
反正现在是能跑了,但要说多顺畅,也就那样吧,凑合用。你要是有别的坑,评论区咱俩碰碰。
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