diff options
| author | shu <nvcsadjkojf@outlook.com> | 2026-09-06 19:41:09 +0800 |
|---|---|---|
| committer | shu <nvcsadjkojf@outlook.com> | 2026-09-06 19:41:09 +0800 |
| commit | 4c4215882e16992fdc054d364af2e3a0ef6f1a22 (patch) | |
| tree | 69e3732feb999e786ce5c051ec98a060073d9842 /README.md | |
| parent | 61c1674e439dd791aee4fdc72e5738bbefed13e9 (diff) | |
新增默认环境配置,通过 VITE_ROUTER_MODE 切换 Hash 与 History 路由,默认使用 Hash;通过 VITE_BASE_URL 配置资源基础路径,默认使用 /。
补充本地环境覆盖、构建方式及部署注意事项文档,保持 .env.local 不纳入版本控制。
桌面侧栏按钮改用 SidebarSimpleIcon,展开时填充、折叠时描边,保留无障碍状态描述。
验证:pnpm lint、pnpm build 和 git diff --check 通过。构建仍有现存的主包超过 500 kB 提示。
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 20 |
1 files changed, 20 insertions, 0 deletions
@@ -2,6 +2,26 @@ This template provides a minimal setup to get React working in Vite with HMR and some Oxlint rules. +## 路由模式 + +通过 `VITE_ROUTER_MODE` 选择路由模式: + +- `.env` 默认设置 `hash`,地址示例为 `/#/about/me`。 +- `.env.local` 可设置 `history`,地址示例为 `/about/me`。此文件已被 Git 忽略。 +- `.env.local` 同时影响本地开发和本地构建;需要构建 Hash 版本时运行 `VITE_ROUTER_MODE=hash pnpm build`。 + +修改环境变量后需重启开发服务或重新构建。History 模式需要服务器配置前端路由回退,并确保深层 URL 下的资源路径正确。 + +## 资源基础路径 + +通过环境变量 `VITE_BASE_URL` 配置 Vite 的 `base`,默认值为 `/`。可在 `.env.local` 中覆盖: + +```dotenv +VITE_BASE_URL=./ +``` + +`./` 适用于 Hash 路由的相对资源部署;History 路由建议使用 `/` 或明确的部署子目录,例如 `/app/`。部署到子目录时,还需配套设置路由的 `basename`。 + Currently, two official plugins are available: - [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs) |
