From 4c4215882e16992fdc054d364af2e3a0ef6f1a22 Mon Sep 17 00:00:00 2001
From: shu <nvcsadjkojf@outlook.com>
Date: Sun, 6 Sep 2026 19:41:09 +0800
Subject: 支持环境变量配置路由模式和资源路径并更新菜单图标
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增默认环境配置，通过 VITE_ROUTER_MODE 切换 Hash 与 History 路由，默认使用 Hash；通过 VITE_BASE_URL 配置资源基础路径，默认使用 /。

补充本地环境覆盖、构建方式及部署注意事项文档，保持 .env.local 不纳入版本控制。

桌面侧栏按钮改用 SidebarSimpleIcon，展开时填充、折叠时描边，保留无障碍状态描述。

验证：pnpm lint、pnpm build 和 git diff --check 通过。构建仍有现存的主包超过 500 kB 提示。
---
 README.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

(limited to 'README.md')

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)
-- 
cgit v1.2.3