Pages 项目结构

本项目是一个 VitePress 站点，核心目录如下：

cloudflare-learning-lab
├── docs
│   ├── .vitepress
│   │   └── config.ts
│   ├── quick-start
│   ├── concepts
│   ├── pages
│   ├── workers
│   ├── r2
│   ├── labs
│   └── deploy
├── functions
│   └── api
│       └── demo.ts
├── wrangler.toml
└── package.json

docs

docs 目录存放 VitePress 文档。

• docs/.vitepress/config.ts：配置导航、侧边栏、主题。
• docs/*.md：Markdown 教程内容。
• docs/.vitepress/theme/：自定义样式。

functions

functions 目录是 Cloudflare Pages Functions。

• functions/api/demo.ts：提供 /api/demo 接口。
• 该函数会在 Pages Functions 或 Workers 本地调试中运行。

wrangler.toml

wrangler.toml 是 wrangler 的配置文件。

关键配置：

name = "cloudflare-learning-lab"
main = "functions/api/demo.ts"

[[r2_buckets]]
binding = "DEMO_BUCKET"
bucket_name = "cloudflare-learning-lab"

binding = "DEMO_BUCKET" 表示 Worker 代码可以通过 env.DEMO_BUCKET 访问 R2。