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:
iven
2026-05-25 13:45:46 +08:00
parent 1a376a255d
commit 8ad4329632
7 changed files with 40 additions and 10 deletions

View File

@@ -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 | 添加微信小程序配置信息和集成契约 |