用途:构建高性能 Jamstack 电商店面。商品与集合页面在构建时预渲染为静态 HTML,便于 CDN 缓存并提升 SEO 与 Core Web Vitals;购物车、结账、账户等动态能力通过客户端 JavaScript 调用无头电商 API 实现。
主要能力:支持 Next.js(含 ISR 增量静态再生)与 Astro(默认零 JS、按需水合)两种方案;对接 Shopify Storefront API、Saleor、commercetools 等无头后端,也可通过 REST/WPGraphQL 或 GraphQL 对接 WooCommerce、Magento;用 generateStaticParams / getStaticPaths 预生成热门商品页;用 ISR 按 tagged fetch 或 Webhook 端点按需重新验证单个商品或集合;用 Zustand 加 persist 中间件实现客户端购物车本地持久化;通过 next.config 配置 CDN 缓存头、stale-while-revalidate 与远程图片域名。
必要用法(保留原样):npx create-next-app@latest my-store --typescript --tailwind --app;npm install @shopify/storefront-api-client graphql;npm create astro@latest -- --template minimal;npx astro add tailwind;npm install @astrojs/node graphql-request。需 Node.js 18+、Redis、邮件服务(SendGrid/AWS SES/Postmark)与 CDN(Cloudflare/CloudFront/Fastly)。
适用场景:目录大且改动少、要求 CDN 亚百毫秒加载;希望前端与电商后端解耦;团队倾向现代 React/Astro 工具链而非平台专有主题;需在建站时合并 CMS(Contentful、Sanity)数据。
限制:示例基于 TypeScript/Node.js,虽称可适配其他栈,但未提供其他语言完整实现;预生成全部商品页会拖慢构建,建议只生成热门商品并由 ISR 处理长尾;ISR 可能返回过期价格;需为远程图片配置允许域名,否则生产环境图片加载失败;按需重新验证端点必须验证密钥令牌。相关技能包括 @shopify-hydrogen、@saleor-development、@pwa-storefront、@image-optimization-cdn、@edge-commerce。