本地部署

本节只覆盖本机开发与预览。生产环境见 Production Deployment。安装步骤见 Installation。

开发服务器

npm run dev

Vite 开发服务器默认 http://localhost:5173，支持热更新。npm start 与该命令等价。

生产构建

npm run build

输出目录为 dist/（不是 CRA 时代的 build/）。产物包括 index.html 与 dist/assets/ 下的打包 CSS/JS，以及从 public/ 复制的静态文件。

本地预览构建结果

npm run preview

用于确认生产包在 locale 深链（如 /zh/Activity）下能否正常打开。若未配置 SPA 回退的静态服务器，刷新子路径可能 404；Vite preview 默认会处理 history fallback。

说明

• 无需配置环境变量。
• 本地同时存在旧的 build/ 目录时，以 dist/ 为准；不要把构建产物提交进 Git。