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
+36 -7
View File
@@ -48,10 +48,10 @@ pnpm dev:h5
### 3. 编译打包
#### 编译为微信小程序
#### 编译为微信小程序(生产环境/正式版)
```bash
# 生产环境编译
# 生产环境编译(调用服务器 APIDEBUG=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
## 项目结构
```