Pages 说明文档

# Cloudflare Pages 用于在 Cloudflare 全球网络上构建全栈应用的 JAMstack 平台。 ## 核心功能 - **基于 Git 的部署**: 从 GitHub/GitLab 自动部署 - **预览部署**: 每个分支/PR 拥有唯一 URL - **Pages Functions**: 基于文件的无服务器路由 (Workers 运行时) - **静态 + 动态**: 智能资源缓存 + 边缘计算 - **智能放置 (Smart Placement)**: 基于流量模式的自动函数优化 - **框架优化**: 支持 SvelteKit, Astro, Nuxt, Qwik, Solid Start ## 部署方法 ### 1. Git 集成 (生产环境) 控制台 → Workers & Pages → 创建 → 连接到 Git → 配置构建 ### 2. 直接上传 bash npx wrangler pages deploy ./dist --project-name=my-project npx wrangler pages deploy ./dist --project-name=my-project --branch=staging ### 3. C3 CLI bash npm create cloudflare@latest my-app # 选择框架 → 自动设置 + 部署 ## 与 Workers 的区别 - **Pages**: 静态站点、JAMstack、框架支持、Git 工作流、基于文件的路由 - **Workers**: 纯 API、复杂路由、WebSockets、定时任务、邮件处理 - **结合使用**: Pages Functions 使用 Workers 运行时，可绑定到 Workers ## 快速入门 bash # 创建 npm create cloudflare@latest # 本地开发 npx wrangler pages dev ./dist # 部署 npx wrangler pages deploy ./dist --project-name=my-project # 类型生成 npx wrangler types --path='./functions/types.d.ts' # 密钥管理 echo "value" | npx wrangler pages secret put KEY --project-name=my-project # 日志 npx wrangler pages deployment tail --project-name=my-project ## 资源 - [Pages 文档](https://developers.cloudflare.com/pages/) - [Functions API](https://developers.cloudflare.com/pages/functions/api-reference/) - [框架指南](https://developers.cloudflare.com/pages/framework-guides/) - [Discord #functions](https://discord.com/channels/595317990191398933/910978223968518144) ## 阅读顺序 **Pages 新手？** 从这里开始： 1. README.md (当前页面) - 概述与快速入门 2. [configuration.md](./configuration.md) - 项目设置、wrangler.jsonc、绑定 3. [api.md](./api.md) - Functions API、路由、上下文 4. [patterns.md](./patterns.md) - 常见实现模式 5. [gotchas.md](./gotchas.md) - 故障排除与陷阱 **快速参考？** 跳转到上述相关文件。 ## 本参考资料包含 - [configuration.md](./configuration.md) - wrangler.jsonc, 构建, 环境变量, 智能放置 - [api.md](./api.md) - Functions API, 绑定, 上下文, 高级模式 - [patterns.md](./patterns