feat: 添加小程序体验版构建配置,确保调用服务器 API

- 修改 build:mp-weixin 脚本,显式添加 --mode production 参数
- 新增 build:mp-weixin:test 脚本,用于体验版构建 (--mode test)
- 创建 .env.test 环境配置,指向服务器 API 并保留 DEBUG=true
- 更新 README.md 文档,说明环境配置和构建命令区别

修复问题:之前构建脚本缺少 --mode 参数,可能导致使用默认开发环境配置 (localhost)
This commit is contained in:
2026-03-18 20:15:43 +08:00
parent 50a456be8b
commit f22338beb3
3 changed files with 47 additions and 11 deletions
+5
View File
@@ -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
+36 -7
View File
@@ -48,10 +48,10 @@ pnpm dev:h5
### 3. 编译打包 ### 3. 编译打包
#### 编译为微信小程序 #### 编译为微信小程序(生产环境/正式版)
```bash ```bash
# 生产环境编译 # 生产环境编译(调用服务器 APIDEBUG=false
npm run build:mp-weixin npm run build:mp-weixin
# 或 # 或
pnpm build:mp-weixin pnpm build:mp-weixin
@@ -59,6 +59,21 @@ pnpm build:mp-weixin
编译输出目录:`unpackage/dist/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. 打开微信开发者工具 1. 打开微信开发者工具
2. 导入目录:`mini-program/unpackage/dist/build/mp-weixin` 2. 导入目录:`mini-program/unpackage/dist/build/mp-weixin`
@@ -80,19 +95,28 @@ pnpm build:h5
项目使用 `.env` 文件管理环境变量: 项目使用 `.env` 文件管理环境变量:
| 文件 | 说明 | | 文件 | 说明 | 用途 |
|------|------| |------|------|------|
| `.env.development` | 开发环境配置 | | `.env.development` | 开发环境配置 | 本地开发调试,指向 localhost |
| `.env.production` | 生产环境配置 | | `.env.test` | 测试环境配置 | 小程序体验版,指向服务器 API |
| `.env.production` | 生产环境配置 | 小程序正式版,指向服务器 API |
**开发环境配置**`.env.development`): **开发环境配置**`.env.development`):
```bash ```bash
VITE_APP_ENV=dev 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_WS_URL=ws://localhost:19089
VITE_DEBUG=true 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`): **生产环境配置**`.env.production`):
```bash ```bash
VITE_APP_ENV=prod VITE_APP_ENV=prod
@@ -101,6 +125,11 @@ VITE_WS_URL=ws://101.200.208.45:19089
VITE_DEBUG=false VITE_DEBUG=false
``` ```
**环境选择指南**
- **本地开发**:使用 `npm run dev:mp-weixin`,自动加载开发环境配置
- **体验版发布**:使用 `npm run build:mp-weixin:test`,使用测试环境配置(服务器 API + DEBUG 模式)
- **正式版发布**:使用 `npm run build:mp-weixin`,使用生产环境配置(服务器 API + 关闭 DEBUG
## 项目结构 ## 项目结构
``` ```
+6 -4
View File
@@ -3,10 +3,11 @@
"private": true, "private": true,
"type": "module", "type": "module",
"scripts": { "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", "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": "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", "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",
"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: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",
"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: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": { "dependencies": {
"@dcloudio/uni-app": "3.0.0-alpha-5000120260211001", "@dcloudio/uni-app": "3.0.0-alpha-5000120260211001",
@@ -22,6 +23,7 @@
"@vue/server-renderer": "3.4.21", "@vue/server-renderer": "3.4.21",
"@vue/shared": "3.4.21", "@vue/shared": "3.4.21",
"@vue/tsconfig": "^0.8.1", "@vue/tsconfig": "^0.8.1",
"cross-env": "^10.1.0",
"vite": "5.2.8" "vite": "5.2.8"
} }
} }