From f22338beb395f1470ba6a16fe0a778fc29f3cd97 Mon Sep 17 00:00:00 2001 From: Peanut Date: Wed, 18 Mar 2026 20:15:43 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=B7=BB=E5=8A=A0=E5=B0=8F=E7=A8=8B?= =?UTF-8?q?=E5=BA=8F=E4=BD=93=E9=AA=8C=E7=89=88=E6=9E=84=E5=BB=BA=E9=85=8D?= =?UTF-8?q?=E7=BD=AE=EF=BC=8C=E7=A1=AE=E4=BF=9D=E8=B0=83=E7=94=A8=E6=9C=8D?= =?UTF-8?q?=E5=8A=A1=E5=99=A8=20API?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 修改 build:mp-weixin 脚本，显式添加 --mode production 参数 - 新增 build:mp-weixin:test 脚本，用于体验版构建 (--mode test) - 创建 .env.test 环境配置，指向服务器 API 并保留 DEBUG=true - 更新 README.md 文档，说明环境配置和构建命令区别 修复问题：之前构建脚本缺少 --mode 参数，可能导致使用默认开发环境配置 (localhost) --- mini-program/.env.test | 5 +++++ mini-program/README.md | 43 ++++++++++++++++++++++++++++++++------- mini-program/package.json | 10 +++++---- 3 files changed, 47 insertions(+), 11 deletions(-) create mode 100644 mini-program/.env.test diff --git a/mini-program/.env.test b/mini-program/.env.test new file mode 100644 index 0000000..568f3ab --- /dev/null +++ b/mini-program/.env.test @@ -0,0 +1,5 @@ +# 体验环境配置（小程序体验版） +VITE_APP_ENV=test +VITE_API_BASE_URL=http://101.200.208.45:19089/api +VITE_WS_URL=ws://101.200.208.45:19089 +VITE_DEBUG=true diff --git a/mini-program/README.md b/mini-program/README.md index 674be37..2f1e6f1 100644 --- a/mini-program/README.md +++ b/mini-program/README.md @@ -48,10 +48,10 @@ pnpm dev:h5 ### 3. 编译打包 -#### 编译为微信小程序 +#### 编译为微信小程序（生产环境/正式版） ```bash -# 生产环境编译 +# 生产环境编译（调用服务器 API，DEBUG=false） npm run build:mp-weixin # 或 pnpm build:mp-weixin @@ -59,6 +59,21 @@ pnpm build:mp-weixin 编译输出目录：`unpackage/dist/build/mp-weixin` +**说明**：此命令用于编译正式版小程序，使用生产环境配置，调用服务器 API。 + +#### 编译为微信小程序（测试环境/体验版） + +```bash +# 测试环境编译（调用服务器 API，DEBUG=true） +npm run build:mp-weixin:test +# 或 +pnpm build:mp-weixin:test +``` + +编译输出目录：`unpackage/dist/test/mp-weixin` + +**说明**：此命令用于编译体验版小程序，使用测试环境配置，调用服务器 API 但保留 DEBUG 模式便于调试。 + **部署步骤**： 1. 打开微信开发者工具 2. 导入目录：`mini-program/unpackage/dist/build/mp-weixin` @@ -80,19 +95,28 @@ pnpm build:h5 项目使用 `.env` 文件管理环境变量： -| 文件 | 说明 | -|------|------| -| `.env.development` | 开发环境配置 | -| `.env.production` | 生产环境配置 | +| 文件 | 说明 | 用途 | +|------|------|------| +| `.env.development` | 开发环境配置 | 本地开发调试，指向 localhost | +| `.env.test` | 测试环境配置 | 小程序体验版，指向服务器 API | +| `.env.production` | 生产环境配置 | 小程序正式版，指向服务器 API | **开发环境配置**（`.env.development`）： ```bash VITE_APP_ENV=dev -VITE_API_BASE_URL=http://localhost:19089 +VITE_API_BASE_URL=http://localhost:19089/api VITE_WS_URL=ws://localhost:19089 VITE_DEBUG=true ``` +**测试环境配置**（`.env.test`）： +```bash +VITE_APP_ENV=test +VITE_API_BASE_URL=http://101.200.208.45:19089/api +VITE_WS_URL=ws://101.200.208.45:19089 +VITE_DEBUG=true +``` + **生产环境配置**（`.env.production`）： ```bash VITE_APP_ENV=prod @@ -101,6 +125,11 @@ VITE_WS_URL=ws://101.200.208.45:19089 VITE_DEBUG=false ``` +**环境选择指南**： +- **本地开发**：使用 `npm run dev:mp-weixin`，自动加载开发环境配置 +- **体验版发布**：使用 `npm run build:mp-weixin:test`，使用测试环境配置（服务器 API + DEBUG 模式） +- **正式版发布**：使用 `npm run build:mp-weixin`，使用生产环境配置（服务器 API + 关闭 DEBUG） + ## 项目结构 ``` diff --git a/mini-program/package.json b/mini-program/package.json index 6a602f8..cb38ceb 100644 --- a/mini-program/package.json +++ b/mini-program/package.json @@ -3,10 +3,11 @@ "private": true, "type": "module", "scripts": { - "dev:mp-weixin": "NODE_ENV=development VITE_CJS_IGNORE_WARNING=1 VITE_USER_NODE_ENV= UNI_PLATFORM=mp-weixin UNI_INPUT_DIR=src UNI_OUTPUT_DIR=unpackage/dist/dev/mp-weixin UNI_APP_X=false uni -p mp-weixin", - "build:mp-weixin": "NODE_ENV=production VITE_CJS_IGNORE_WARNING=1 VITE_USER_NODE_ENV= UNI_PLATFORM=mp-weixin UNI_INPUT_DIR=src UNI_OUTPUT_DIR=unpackage/dist/build/mp-weixin UNI_APP_X=false uni build -p mp-weixin --outDir unpackage/dist/build/mp-weixin", - "dev:h5": "NODE_ENV=development VITE_CJS_IGNORE_WARNING=1 VITE_USER_NODE_ENV= UNI_PLATFORM=h5 UNI_INPUT_DIR=src UNI_APP_X=false uni -p h5", - "build:h5": "NODE_ENV=production VITE_CJS_IGNORE_WARNING=1 VITE_USER_NODE_ENV= UNI_PLATFORM=h5 UNI_INPUT_DIR=src UNI_APP_X=false uni build -p h5" + "dev:mp-weixin": "cross-env NODE_ENV=development VITE_CJS_IGNORE_WARNING=1 VITE_USER_NODE_ENV= UNI_PLATFORM=mp-weixin UNI_INPUT_DIR=src UNI_OUTPUT_DIR=unpackage/dist/dev/mp-weixin UNI_APP_X=false uni -p mp-weixin", + "build:mp-weixin": "cross-env NODE_ENV=production VITE_CJS_IGNORE_WARNING=1 VITE_USER_NODE_ENV= UNI_PLATFORM=mp-weixin UNI_INPUT_DIR=src UNI_OUTPUT_DIR=unpackage/dist/build/mp-weixin UNI_APP_X=false uni build -p mp-weixin --mode production --outDir unpackage/dist/build/mp-weixin", + "build:mp-weixin:test": "cross-env NODE_ENV=production VITE_CJS_IGNORE_WARNING=1 VITE_USER_NODE_ENV= UNI_PLATFORM=mp-weixin UNI_INPUT_DIR=src UNI_OUTPUT_DIR=unpackage/dist/test/mp-weixin UNI_APP_X=false uni build -p mp-weixin --mode test --outDir unpackage/dist/test/mp-weixin", + "dev:h5": "cross-env NODE_ENV=development VITE_CJS_IGNORE_WARNING=1 VITE_USER_NODE_ENV= UNI_PLATFORM=h5 UNI_INPUT_DIR=src UNI_APP_X=false uni -p h5", + "build:h5": "cross-env NODE_ENV=production VITE_CJS_IGNORE_WARNING=1 VITE_USER_NODE_ENV= UNI_PLATFORM=h5 UNI_INPUT_DIR=src UNI_APP_X=false uni build -p h5" }, "dependencies": { "@dcloudio/uni-app": "3.0.0-alpha-5000120260211001", @@ -22,6 +23,7 @@ "@vue/server-renderer": "3.4.21", "@vue/shared": "3.4.21", "@vue/tsconfig": "^0.8.1", + "cross-env": "^10.1.0", "vite": "5.2.8" } }