diff --git a/.env.develop b/.env.develop new file mode 100644 index 0000000..2029c7e --- /dev/null +++ b/.env.develop @@ -0,0 +1,14 @@ +# develop 分支测试环境构建配置 +VITE_APP_ENV = "develop" +VITE_APP_ENV_LABEL = "测试环境" + +VITE_PUBLIC_PATH = / + +VITE_ROUTER_HISTORY = "hash" + +VITE_CDN = false + +VITE_COMPRESSION = "none" + +# 本地调试 develop mode 时的后端代理目标;线上测试环境由 Nginx 将 /api 代理到测试后端。 +VITE_API_PROXY_TARGET = "http://localhost:3501" diff --git a/.env.development b/.env.development index a96f19a..50992b3 100644 --- a/.env.development +++ b/.env.development @@ -1,6 +1,9 @@ # 平台本地运行端口号 VITE_PORT = 8848 +VITE_APP_ENV = "local" +VITE_APP_ENV_LABEL = "本地环境" + # 开发环境读取配置文件路径 VITE_PUBLIC_PATH = / diff --git a/.env.production b/.env.production index 5a15f92..fec38f9 100644 --- a/.env.production +++ b/.env.production @@ -1,4 +1,5 @@ # 线上环境平台打包路径 +VITE_APP_ENV = "production" VITE_APP_ENV_LABEL = "生产环境" VITE_PUBLIC_PATH = / diff --git a/.env.staging b/.env.staging index 65b57e3..8810a71 100644 --- a/.env.staging +++ b/.env.staging @@ -1,7 +1,10 @@ -# 预发布也需要生产环境的行为 +# 预发布当前按 develop/测试环境标识 # https://cn.vitejs.dev/guide/env-and-mode.html#modes # NODE_ENV = development +VITE_APP_ENV = "develop" +VITE_APP_ENV_LABEL = "测试环境" + VITE_PUBLIC_PATH = / # 预发布环境路由历史模式(Hash模式传"hash"、HTML5模式传"h5"、Hash模式带base参数传"hash,base参数"、HTML5模式带base参数传"h5,base参数") diff --git a/.env.test b/.env.test index 4b4879a..84c3fec 100644 --- a/.env.test +++ b/.env.test @@ -1,4 +1,5 @@ # 测试环境构建配置 +VITE_APP_ENV = "develop" VITE_APP_ENV_LABEL = "测试环境" VITE_PUBLIC_PATH = / diff --git a/README.md b/README.md index 9e0f702..764ca0d 100644 --- a/README.md +++ b/README.md @@ -86,7 +86,8 @@ http://localhost:8848/ | `pnpm dev` | 启动 Vite 开发服务,默认端口来自 `.env.development` 的 `VITE_PORT=8848` | 本地开发 | | `pnpm serve` | `pnpm dev` 的别名 | 兼容习惯命令 | | `pnpm build` | 清理 `dist` 后执行生产构建,内存上限设为 8192MB | 发布前打包 | -| `pnpm build:test` | 使用 `test` mode 构建测试环境静态产物 | 测试环境构建 | +| `pnpm build:develop` | 使用 `develop` mode 构建测试环境静态产物 | 测试环境构建 | +| `pnpm build:test` | `pnpm build:develop` 的兼容命令 | 旧测试构建入口 | | `pnpm build:prod` | `pnpm build` 的生产构建别名 | 生产环境构建 | | `pnpm build:staging` | 使用 `staging` mode 构建 | 预发布环境验证 | | `pnpm report` | 构建并打开 Rollup 可视化分析报告 | 分析包体积 | @@ -118,9 +119,10 @@ http://localhost:8848/ ## 后端对接 -开发环境通过 Vite 代理把 `/api` 转发到 `VITE_API_PROXY_TARGET`,默认值为 `http://localhost:3500`。相关配置位于: +开发环境通过 Vite 代理把 `/api` 转发到 `VITE_API_PROXY_TARGET`,默认值为 `http://localhost:3500`。页面右上角环境标识按 `VITE_APP_ENV=local/develop/production` 显示“本地环境”“测试环境”“生产环境”。相关配置位于: - `.env.development` +- `.env.develop` - `vite.config.ts` 当前已对接接口: @@ -178,10 +180,11 @@ http://localhost:8848/ ## 配置说明 - `.env`: 全局默认配置,目前包含端口和是否隐藏首页。 -- `.env.development`: 开发环境端口、路由模式、API 代理目标。 -- `.env.test`: 测试环境构建配置;线上测试站点的 `/api` 应由 Nginx 代理到测试后端。 -- `.env.staging`: 预发布构建配置,可开启 CDN。 -- `.env.production`: 生产构建配置。 +- `.env.development`: 本地开发环境端口、路由模式、API 代理目标,`VITE_APP_ENV=local`,页面标识为“本地环境”。 +- `.env.develop`: develop/测试环境构建配置,`VITE_APP_ENV=develop`,页面标识为“测试环境”。 +- `.env.test`: 兼容旧测试 mode 的构建配置,语义同 develop;线上测试站点的 `/api` 应由 Nginx 代理到测试后端。 +- `.env.staging`: 预发布构建配置,当前按 develop/测试环境标识,可开启 CDN。 +- `.env.production`: 生产构建配置,`VITE_APP_ENV=production`,页面标识为“生产环境”。 - `public/platform-config.json`: pure-admin 运行时平台配置,例如标题、布局、主题、标签页和菜单搜索历史。 ## 环境构建约定 diff --git a/package.json b/package.json index df0f6c3..e6edb13 100644 --- a/package.json +++ b/package.json @@ -7,7 +7,8 @@ "dev": "NODE_OPTIONS=--max-old-space-size=4096 vite", "serve": "pnpm dev", "build": "rimraf dist && NODE_OPTIONS=--max-old-space-size=8192 vite build", - "build:test": "rimraf dist && vite build --mode test", + "build:develop": "rimraf dist && vite build --mode develop", + "build:test": "pnpm build:develop", "build:prod": "pnpm build", "build:staging": "rimraf dist && vite build --mode staging", "report": "rimraf dist && vite build", diff --git a/src/App.vue b/src/App.vue index 7294c44..59c0e2a 100644 --- a/src/App.vue +++ b/src/App.vue @@ -1,5 +1,8 @@