路径 A:Hydrogen(推荐)
Shopify 官方 React 框架,2022 年开源,2023 年集成到 Remix 之上。
优势:
- 与 Shopify 后端深度集成(Storefront API 内置)
- Oxygen 托管(Shopify 自家边缘网络部署)免费
- 内置 SEO、缓存、组件库
- 持续接收 Shopify 官方维护
适用:
- 90% 选择 Headless 的店铺第一选项
- 团队熟悉 React 但未深耕复杂前端架构
项目结构:
hydrogen-shop/
├── app/
│ ├── routes/ # Remix 路由
│ │ ├── ($lang)._index.tsx
│ │ ├── products.$handle.tsx
│ │ └── collections.$handle.tsx
│ ├── components/
│ └── lib/
├── public/
└── package.json
部署:npm create @shopify/hydrogen → npx shopify hydrogen deploy,连接到 Oxygen 即上线。
路径 B:Next.js + Storefront API
最自由的路径,但需要自己处理与 Shopify 的所有集成。
优势:
- 完全自定义部署目标(Vercel、Cloudflare、AWS、自建)
- 可深度集成非 Shopify 系统(CMS、ERP、CDP)
- 团队已有 Next.js 经验时启动快
劣势:
- 没有 Shopify 默认的边缘缓存、组件等支持
- 应用集成需要每个单独对接
- 升级 Storefront API 版本时需自己跟进
适用:已有成熟 Next.js 站点,想接入 Shopify 后端。