blob: 5693e485e1372df75c6f4e1151d340b337a30af4 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
|
# React + TypeScript + Vite
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)
- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
## React Compiler
The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
## Expanding the Oxlint configuration
If you are developing a production application, we recommend enabling type-aware lint rules by installing `oxlint-tsgolint` and editing `.oxlintrc.json`:
```json
{
"$schema": "./node_modules/oxlint/configuration_schema.json",
"plugins": ["react", "typescript", "oxc"],
"options": {
"typeAware": true
},
"rules": {
"react/rules-of-hooks": "error",
"react/only-export-components": ["warn", { "allowConstantExport": true }]
}
}
```
See the [Oxlint rules documentation](https://oxc.rs/docs/guide/usage/linter/rules) for the full list of rules and categories.
|
