Static Assets 说明文档

# Cloudflare 静态资源技能参考 关于使用 Cloudflare Workers 部署和配置静态资源的专家指南。本技能涵盖配置模式、路由架构、资源绑定使用，以及针对 SPA、SSG 站点和全栈应用的最佳实践。 ## 快速开始 c // wrangler.jsonc { "name": "my-app", "main": "src/index.ts", "compatibility_date": "2025-01-01", "assets": { "directory": "./dist" } } typescript // src/index.ts export default { async fetch(request: Request, env: Env): Promise { return env.ASSETS.fetch(request); } }; 部署: `wrangler deploy` ## 何时使用 Workers 静态资源 vs Pages | 因素 | Workers 静态资源 | Cloudflare Pages | |--------|----------------------|------------------| | **使用场景** | 混合应用 (静态 + 动态 API) | 静态站点, SSG | | **Worker 控制** | 完全路由控制 | 有限 (函数) | | **配置** | 代码优先，灵活 | 基于 Git，约定式 | | **动态路由** | Worker 优先模式 | 函数 (_functions/) | | **最佳适用** | 全栈应用, 带 API 的 SPA | Jamstack, 静态文档 | **决策树:** - 需要自定义路由逻辑？ → Workers 静态资源 - 纯静态站点或 SSG？ → Pages - API 路由 + SPA？ → Workers 静态资源 - 框架 (Next, Nuxt, Remix)？ → Pages ## 阅读顺序 1. **configuration.md** - 设置、wrangler.jsonc 选项、路由模式 2. **api.md** - ASSETS 绑定 API、请求/响应处理 3. **patterns.md** - 常见模式 (SPA, API 路由, 认证, A/B 测试) 4. **gotchas.md** - 限制、错误、性能技巧 ## 本参考内容 - **[configuration.md](configuration.md)** - 设置、部署、配置 - **[api.md](api.md)** - API 端点、方法、接口 - **[patterns.md](patterns.md)** - 常见模式、用例、示例 - **[gotchas.md](gotchas.md)** - 故障排除、最佳实践、限制 ## 另请参阅 - [Cloudflare Workers 文档](https://developers.cloudflare.com/workers/) - [静态资源文档](https://developers.cloudflare.com/workers/static-assets/) - [Cloudflare Pages](https://developers.cloudflare.com/pages/)