本地部署与预览
完整构建预览（推荐）
与生产环境行为一致：
npm run build
npm run serve
访问终端输出的本地地址（通常 http://localhost:3000）。
Wrangler 本地预览
模拟 Cloudflare Workers 静态资源服务：
npm run preview
等价于 npm run build && wrangler dev。
开发服务器
快速迭代时使用：
npm start
| 场景 | 推荐方式 |
|---|---|
| 改 Markdown 内容 | npm start 或 build + serve |
改 sidebars.ts / docusaurus.config.ts | 需重启 npm start |
| 合并 PR 前最终检查 | 必须 npm run build |
| 验证 Workers 部署形态 | npm run preview |
清理缓存
构建异常时可清理 Docusaurus 缓存：
npm run clear
npm run build
类型检查
npm run typecheck
常见错误
- 端口占用：修改启动命令或结束占用 3000 端口的进程
- build 失败：查看终端报错，常见为 doc ID 不存在、Markdown 语法错误、broken link
- 修改 sidebar 不生效：重启 dev server