aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/README.md
diff options
context:
space:
mode:
authorshu <nvcsadjkojf@outlook.com>2026-09-06 19:41:09 +0800
committershu <nvcsadjkojf@outlook.com>2026-09-06 19:41:09 +0800
commit4c4215882e16992fdc054d364af2e3a0ef6f1a22 (patch)
tree69e3732feb999e786ce5c051ec98a060073d9842 /README.md
parent61c1674e439dd791aee4fdc72e5738bbefed13e9 (diff)
支持环境变量配置路由模式和资源路径并更新菜单图标HEADmain
新增默认环境配置,通过 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.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/README.md b/README.md
index d6af7e3..5693e48 100644
--- a/README.md
+++ b/README.md
@@ -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)