签入版本

RXThinkCMF_Laravel13_NaiveVue/zh/deploy/frontend.md

@@ -8,20 +8,20 @@
 
 | 依赖 | 版本要求 | 说明 |
 |------|----------|------|
-| Node.js | >= 18.0 | JavaScript 运行时 |
-| pnpm | >= 8.0 | 包管理工具 |
+| Node.js | >= 14.18（建议 18+，实测 22 LTS） | JavaScript 运行时（`ui/` 为 Vite 3） |
+| pnpm | >= 9.0 | 包管理工具（`ui/pnpm-lock.yaml`） |
 | Nginx | >= 1.20 | Web 服务器 |
 
 ## 构建
 
 ```bash
-# 进入前端项目目录
+# 进入前端项目目录（注意：前端在 ui/ 子目录）
 cd ui
 
 # 安装项目依赖（从 pnpm-lock.yaml 精确安装，确保版本一致）
 pnpm install
 
-# 执行生产环境构建（Vite 会压缩代码、Tree-shaking、分包）
+# 执行生产环境构建（Vite 压缩代码、Tree-shaking、分包 + postBuild 后处理）
 pnpm build
 ```
 
@@ -29,12 +29,16 @@ pnpm build
 
 ### 环境变量配置
 
-构建前可修改环境变量：
+构建前可修改 `ui/.env.production`：
 
 ```bash
-# .env.production — 生产环境构建配置
-VITE_GLOB_API_URL=/api              # API 基础路径（Nginx 代理到后端）
-VITE_GLOB_API_URL_PREFIX=           # API 路径前缀（一般留空）
+# ui/.env.production — 生产环境构建配置
+VITE_GLOB_API_URL =                # API 基础路径（留空表示同源，由 Nginx 代理）
+VITE_GLOB_API_URL_PREFIX = /api    # 接口前缀（后端路由统一在 /api 下）
+VITE_GLOB_UPLOAD_URL =             # 图片上传地址（跨域部署时配置后端域名）
+VITE_GLOB_IMG_URL =                # 图片前缀地址
+VITE_DROP_CONSOLE = true           # 删除 console 调试语句
+VITE_BUILD_COMPRESS = 'none'       # 构建压缩：gzip / brotli / none
 ```
 
 ## Nginx 配置
@@ -81,7 +85,7 @@ server {
     # -----------------------------------------------------------------
     # API 反向代理
     # -----------------------------------------------------------------
-    # 将 /api/ 开头的请求转发到后端 ThinkPHP 服务
+    # 将 /api/ 开头的请求转发到后端 Laravel 服务
     # proxy_pass 末尾的 / 表示替换匹配的路径前缀
     location /api/ {
         proxy_pass http://127.0.0.1:8000;           # 后端服务地址
@@ -123,6 +127,7 @@ nginx -s reload
 | 静态资源 404 | 路径错误 | 检查 `root` 路径是否正确 |
 | 白屏 | 构建失败或路径错误 | 检查构建日志和 Nginx 错误日志 |
 | 样式错乱 | 字体文件加载失败 | 检查字体文件路径和 CORS 配置 |
+| 登录后接口 401 | 跨域部署时 token 未携带 | 检查 `VITE_GLOB_API_URL` 与后端 `CORS_ALLOW_ORIGIN` 是否一致 |
 
 ## 相关文档