部署指南
一、本地开发与构建
开发环境
npm start
使用 Create React App 开发服务器,支持热更新。默认访问 http://localhost:3000。
构建生产版本
npm run build
输出至 build/ 目录,包含优化后的 HTML、JS、CSS 及静态资源。
二、生产部署(Cloudflare Pages)
项目生产环境使用 Cloudflare Pages 托管。
| 配置项 | 值 |
|---|---|
| 构建命令 | npm run build |
| 发布目录 | build |
| SPA 支持 | 默认支持,无需额外配置 |
部署步骤
- 在 Cloudflare Dashboard 创建 Pages 项目
- 连接 GitHub 仓库,选择对应分支
- 按上表设置构建命令与发布目录
- 部署后每次 push 将自动构建并发布
环境变量
若有需要,在项目 Settings → Environment variables 中配置。
附录:其他托管方案
| 平台 | 构建命令 | 发布目录 | 备注 |
|---|---|---|---|
| Netlify / Vercel | npm run build | build | 连接 Git 即可 |
| GitHub Pages | npm run build | build | 可用 gh-pages 或 Actions |
| Nginx 自托管 | — | build/ 目录 | 需配置 SPA 回退 |
Nginx SPA 回退
自托管时,未匹配路径需返回 index.html:
location / {
try_files $uri $uri/ /index.html;
}