chore(mp): 配置优化 + 文档更新
- config: virtualHost + native-components 拷贝配置 - project.config: skylineRenderEnable=false 调试用 - app.config: 移除 lazyCodeLoading 注释(已在 config/index.ts 控制) - dev.ps1: WECHAT_DEV_MODE=false(真机测试用) - wiki: 更新 DevTools 卡死根因 + 构建模式说明 - CLAUDE.md: 添加 graphify 知识图谱规则
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: 开发环境
|
||||
updated: 2026-05-16
|
||||
updated: 2026-05-25
|
||||
status: stable
|
||||
tags: [infrastructure, dev-environment, windows, postgresql]
|
||||
---
|
||||
@@ -128,12 +128,18 @@ cd apps/web && pnpm build # 构建生产版本
|
||||
### 微信小程序
|
||||
|
||||
```bash
|
||||
cd apps/miniprogram && pnpm run dev:weapp # 小程序开发模式(微信开发者工具打开 dist/)
|
||||
cd apps/miniprogram && pnpm run build:weapp # 小程序生产构建
|
||||
cd apps/miniprogram && pnpm run dev:weapp # ✅ 开发调试(必须用这个!使用 .env 中的开发地址)
|
||||
cd apps/miniprogram && pnpm run build:weapp # 生产构建(使用 .env.production 中的生产域名,DevTools 中不可用)
|
||||
cd apps/miniprogram && pnpm run dev:h5 # H5 浏览器预览(端口 10086,推荐调试用)
|
||||
cd apps/miniprogram && pnpm run build:h5 # H5 生产构建
|
||||
```
|
||||
|
||||
> **构建模式区分(重要):**
|
||||
> - `dev:weapp` → `NODE_ENV=development` → 加载 `.env` → `TARO_APP_API_URL=http://192.168.31.123:3000/api/v1`
|
||||
> - `build:weapp` → `NODE_ENV=production` → 加载 `.env.production` → `TARO_APP_API_URL=https://api.hms.example.com/api/v1`
|
||||
>
|
||||
> **DevTools 中调试必须用 `dev:weapp`**,否则请求打到生产域名(无 TLS)→ `ERR_SSL_PROTOCOL_ERROR` → 离线抑制触发 → DevTools 卡死。这是一个已踩坑的陷阱(2026-05-25)。
|
||||
|
||||
> **调试建议:** 日常 UI 开发和页面调试优先用 `dev:h5`(浏览器热更新 + DevTools),完成后在微信开发者工具中做最终验证。H5 模式下微信特有 API(`wx.login`、`Taro.request` 微信登录态等)不可用,但页面布局和交互可完整预览。
|
||||
>
|
||||
> H5 模式通过 `.env.h5` 将 API URL 设为 `/api/v1`(相对路径),dev server 自动代理到 `localhost:3000`,无需处理 CORS。
|
||||
@@ -190,6 +196,7 @@ cd apps/web && pnpm install && pnpm dev
|
||||
|
||||
| 日期 | 变更 |
|
||||
|------|------|
|
||||
| 2026-05-25 | 明确 dev:weapp vs build:weapp 构建模式区分,记录 .env.production 导致 DevTools 卡死的陷阱 |
|
||||
| 2026-04-26 | 从 CLAUDE.md 迁移:常用命令(§9) |
|
||||
| 2026-04-25 | 外部化微信凭据和健康加密密钥为环境变量;添加 4 个新的必设环境变量 |
|
||||
| 2026-04-24 | 添加微信小程序配置信息和集成契约 |
|
||||
|
||||
Reference in New Issue
Block a user