
## 一、适用场景

- 静态网站（HTML / CSS / JS）
- 已构建完成的前端产物（如 Next.js `export` 后的目录）
- 文件数量 **超过 1000**（网页直接上传会失败）
- 目录中包含 `index.html`
---

## 二、为什么要用 Wrangler CLI？

|方式|文件上限|是否推荐|
|---|---|---|
|网页直接上传|1000|❌ 不适合大型项目|
|Wrangler CLI|**20,000**|✅ 官方推荐|
|Git 自动部署|不限|✅ 生产推荐|

---

## 三、环境准备

### 1️⃣ 安装 Node.js

确保 Node.js ≥ 16
```bash
node -v
npm -v
```
---

### 2️⃣ 安装 Wrangler CLI

```bash
npm install -g wrangler
```

验证安装：
```bash
wrangler -v
```
---

### 3️⃣ 登录 Cloudflare

```bash
wrangler login
```
浏览器会自动打开，登录你的 Cloudflare 账号即可。

---

## 四、项目目录要求（非常重要）

你的**部署目录**必须满足：
- ✅ 包含 `index.html`
- ✅ 是**最终静态文件目录**
- ❌ 不是源码目录（不是 src / pages / app）

示例结构：

```
project-root/
├─ index.html
├─ 404.html
├─ _next/
├─ images/
├─ fonts/
├─ sw.js
└─ …
```

---

## 五、部署到 Cloudflare Pages

### ✅ 最简单、推荐的方式（一次性可用）

进入静态站点根目录，执行：
```bash
wrangler pages deploy dist
wrangler pages deploy dist
```

> `.` 表示部署“当前目录”，**不能省略**

---

### 📌 首次部署时会发生什么？

Wrangler 会提示你：
- 创建 Pages 项目
- 输入项目名（如 `pdfcraft`）
- 选择是否绑定已有项目

👉 **一路回车即可**

---

## 六、指定项目名（可选）
如果你不想每次输入项目名：

```bash
wrangler pages deploy . --project-name pdfcraft
```

---

## 七、长期推荐配置（wrangler.toml）
在项目根目录创建 `wrangler.toml`：

```toml
name = "pdfcraft"
pages_build_output_dir = "."
```

之后直接运行即可：

```bash
wrangler pages deploy
```

---

## 八、部署成功后的结果
部署完成后你会得到类似输出：

```
✨ Deployment complete!
🌍 https://pdfcraft.pages.dev
```

- `*.pages.dev` 是默认访问域名
- 可在 Cloudflare 控制台绑定自定义域名

---
