关键结论
纯静态的 Astro 站点不需要 @astrojs/cloudflare adapter。 直接 astro build 出 dist/,然后把 dist/ 推给 Cloudflare Pages 就完事了。
事实上,从 2025 年起 @astrojs/cloudflare 不再支持 Cloudflare Pages(迁往 Workers)。所以:
| 你的情况 | 推荐路径 |
|---|---|
| 纯静态博客 / 文档站 | 不要装 adapter,直接 Pages 静态部署 |
| 有 SSR / API routes | 用 adapter,目标改为 Workers,弃用 Pages |
配置三步走
astro build产物在dist/- Cloudflare Pages 关联 GitHub 仓库
- Build command:
npm run build,Output directory:dist
剩下的就交给 Cloudflare 的 CI 自动跑了。