签入版本

2026-10-11 19:06:33 +08:00
parent 17d28de8b7
commit 4084c6bd17
674 changed files with 58855 additions and 1892 deletions
@@ -10,10 +10,8 @@
 ui/
 ├── .env                    # 所有环境通用配置（端口、标题）
 ├── .env.development        # 开发环境（pnpm dev，默认 mode）
-├── .env.production         # 生产构建（pnpm build）
-├── .env.test               # 测试构建（pnpm build:test）
-├── .env.uat                # UAT 构建（pnpm build:uat）
-└── .env.dev                # dev 模式构建（pnpm build:dev）
+├── .env.production         # 生产构建（pnpm build / build:prod）
+└── .env.test               # 测试构建（pnpm build:test）
 ```

 **加载优先级：** `.env.{mode}` > `.env`（Vite 标准加载规则，可用 `.env.{mode}.local` 做本地覆盖）
@@ -24,7 +22,7 @@ ui/

 ```bash
 # 开发服务器端口
-VITE_PORT = 8001
+VITE_PORT = 8002

 # 公共基础路径（通常为 /）
 VITE_PUBLIC_PATH = /
@@ -36,7 +34,7 @@ VITE_USE_MOCK = false
 VITE_DROP_CONSOLE = true

 # 开发代理（JSON 数组格式：[["前缀","目标地址"]]）
-VITE_PROXY=[["/api","http://admin.laravel13.elevue/api"]]
+VITE_PROXY=[["/api","http://admin.laravel13.antdvue/api"]]

 # API 接口基础路径（留空，由代理处理）
 VITE_GLOB_API_URL =
@@ -57,7 +55,7 @@ VITE_GLOB_API_URL_PREFIX = /api
 ```

 :::tip 代理目标地址
-`VITE_PROXY` 当前默认指向 Laragon 虚拟主机 `http://admin.laravel13.elevue/api`；使用 `php artisan serve` 时改为直连 `http://localhost:8000/api`（见 [2.2 Laragon 环境搭建](/zh/quickstart/laragon.html)）。修改后需重启 `pnpm dev`。
+`VITE_PROXY` 当前默认指向 Laragon 虚拟主机 `http://admin.laravel13.antdvue/api`；使用 `php artisan serve` 时改为直连 `http://admin.laravel13.antdvue/api`（见 [2.2 Laragon 环境搭建](/zh/quickstart/laragon.html)）。修改后需重启 `pnpm dev`。
 :::

 ## 生产环境配置
@@ -99,7 +97,7 @@ VITE_BUILD_COMPRESS_DELETE_ORIGIN_FILE = false

 | 环境 | 值 | 说明 |
 |------|-----|------|
-| 开发 | `8001` | 前端开发服务器端口 |
+| 开发 | `8002` | 前端开发服务器端口 |
 | 生产 | 不生效 | 生产环境由 Nginx 提供服务 |

 ### VITE_PUBLIC_PATH — 公共基础路径
@@ -121,10 +119,10 @@ VITE_BUILD_COMPRESS_DELETE_ORIGIN_FILE = false

 ```bash
 # 当前 .env.development 中的值（Laragon 虚拟主机）
-VITE_PROXY=[["/api","http://admin.laravel13.elevue/api"]]
+VITE_PROXY=[["/api","http://admin.laravel13.antdvue/api"]]

 # 直连 artisan serve 时的写法
-VITE_PROXY=[["/api","http://localhost:8000/api"]]
+VITE_PROXY=[["/api","http://admin.laravel13.antdvue/api"]]
 ```

 **格式：** JSON 数组，每项为 `[前缀, 目标地址]`
@@ -134,7 +132,7 @@ VITE_PROXY=[["/api","http://localhost:8000/api"]]
 **多代理示例：**

 ```bash
-VITE_PROXY = [["/api","http://localhost:8000/api"],["/uploads","http://localhost:8000/uploads"]]
+VITE_PROXY = [["/api","http://admin.laravel13.antdvue/api"],["/uploads","http://admin.laravel13.antdvue/uploads"]]
 ```

 ### VITE_GLOB_API_URL_PREFIX — API 前缀
@@ -246,7 +244,7 @@ export function createProxy(list: ProxyList = []) {
 server: {
  proxy: {
    '/api': {
-      target: 'http://localhost:8000/api',  // 目标地址（VITE_PROXY 驱动，含 /api 前缀）
+      target: 'http://admin.laravel13.antdvue/api',  // 目标地址（VITE_PROXY 驱动，含 /api 前缀）
      changeOrigin: true,                    // 修改请求头 Origin
      ws: true,                               // 支持 WebSocket
      rewrite: (path) => path.replace(new RegExp('^/api'), ''), // 去掉前缀，由目标地址补回
@@ -262,7 +260,7 @@ server: {
    │
    ▼ Vite proxy
    │
-    ▼ 转发到: http://localhost:8000/api/user/page
+    ▼ 转发到: http://admin.laravel13.antdvue/api/user/page
 ```

 ## 构建命令
@@ -294,7 +292,7 @@ ui/dist/
 │   ├── index-xxx.js        # 主 JS（带 hash）
 │   ├── index-xxx.css       # 主 CSS（带 hash）
 │   ├── vue-xxx.js          # Vue 相关（分包）
-│   └── element-xxx.js      # Element Plus（分包）
+│   └── antd-xxx.js         # AntDesign Vue（分包）
 ├── favicon.ico
 └── static/                 # 静态资源
 ```
@@ -339,22 +337,19 @@ server {

 ## 多环境配置

-### 测试 / UAT 环境（项目实际提供）
+### 测试环境（项目实际提供）

 ```bash
 # .env.test（pnpm build:test）
 VITE_GLOB_API_URL =
 VITE_GLOB_API_URL_PREFIX = /api
 VITE_DROP_CONSOLE = true
-
-# .env.uat（pnpm build:uat）同结构，按需调整
 ```

 构建命令（见 `ui/package.json` scripts）：

 ```bash
 pnpm build:test    # 测试环境构建
-pnpm build:uat     # UAT 环境构建
 pnpm build:prod    # 生产环境构建
 ```

@@ -362,10 +357,10 @@ pnpm build:prod    # 生产环境构建

 | 变量 | 开发 | 测试 | 生产 |
 |------|------|------|------|
-| `VITE_PORT` | 8001 | - | - |
+| `VITE_PORT` | 8002 | - | - |
 | `VITE_GLOB_API_URL` | 留空 | 留空 | 留空 |
 | `VITE_GLOB_API_URL_PREFIX` | /api | /api | /api |
-| `VITE_PROXY` | `[["/api","http://admin.laravel13.elevue/api"]]` | - | - |
+| `VITE_PROXY` | `[["/api","http://admin.laravel13.antdvue/api"]]` | - | - |
 | `VITE_GLOB_IMG_URL` | 留空 | 留空 | 留空（按需配置 CDN） |
 | `VITE_DROP_CONSOLE` | true | true | true |
 | `VITE_USE_MOCK` | false | false | false |
@@ -376,7 +371,7 @@ pnpm build:prod    # 生产环境构建

 **原因：** 代理配置错误或后端未启动。

-**解决：** 检查 `.env.development` 中 `VITE_PROXY` 的目标地址是否正确，`curl http://localhost:8000/api/captcha` 验证后端；改完配置重启 `pnpm dev`。
+**解决：** 检查 `.env.development` 中 `VITE_PROXY` 的目标地址是否正确，`curl http://admin.laravel13.antdvue/api/captcha` 验证后端；改完配置重启 `pnpm dev`。

 ### 问题 2：生产环境 API 请求跨域