# 基础库版本问题解决方案

## 🔧 方案一：使用更老的稳定版本（推荐）

已将版本改为 **2.19.4**，这是一个非常稳定的老版本，几乎都能下载成功。

**配置位置：** `manifest.json`
```json
"mp-weixin" : {
    "libVersion" : "2.19.4"
}
```

## 🛠️ 方案二：在微信开发者工具中手动设置

如果 manifest.json 中的配置仍然下载失败，可以在微信开发者工具中手动设置：

### 步骤：

1. **打开微信开发者工具**
2. **点击右上角"详情"**
3. **选择"本地设置"标签**
4. **勾选"不使用体验版基础库"**
5. **选择任意可用的基础库版本**（如 2.24.7、2.23.4 等）

```
┌─────────────────────────────────────┐
│  微信开发者工具                      │
│                                     │
│  [ 详情 ]                           │
│  ┌─────────────────────────────┐   │
│  │ 本地设置                    │   │
│  │                             │   │
│  │ ☑ 不使用体验版基础库         │   │
│  │                             │   │
│  │ 基础库版本：2.24.7 ▼       │   │
│  │                             │   │
│  └─────────────────────────────┘   │
└─────────────────────────────────────┘
```

## 🌐 方案三：检查网络和代理

### 可能的原因：
- 网络连接问题
- 公司防火墙限制
- 需要代理

### 解决方法：

1. **检查网络连接**
   ```
   ping developers.weixin.qq.com
   ```

2. **配置代理（如果需要）**
   - 微信开发者工具 → 设置 → 代理设置
   - 使用系统代理或自定义代理

3. **关闭防火墙临时测试**

## 📱 方案四：使用真机调试

如果模拟器基础库下载失败，可以直接在真机上调试：

1. **在微信开发者工具中点击"预览"**
2. **使用微信扫码**
3. **在真机上查看效果**

真机使用微信客户端的基础库，不需要单独下载。

## 🔄 方案五：重新安装微信开发者工具

如果以上都不行，可能是开发者工具本身的问题：

1. **卸载当前的微信开发者工具**
2. **从官网下载最新版本**
   - https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html
3. **安装后重新运行**

## ⚙️ 方案六：移除 libVersion 配置（不推荐）

如果实在不行，可以移除版本限制：

```json
"mp-weixin" : {
    "appid" : "",
    "setting" : {
        "urlCheck" : false,
        "es6" : true,
        "minified" : true,
        "postcss" : true
    },
    "usingComponents" : true
    // 移除 libVersion，让工具自动选择
}
```

**缺点：** 可能会导致不同开发者工具版本之间的不一致。

## 🎯 推荐操作顺序

1. ✅ **先用方案一**（已配置 2.19.4）
2. ⬜ 不行就用方案二（手动设置）
3. ⬜ 真机调试用方案四
4. ⬜ 最后考虑方案五（重装）

## 📋 可用的基础库版本列表

以下版本通常都可以正常下载：

| 版本号 | 发布日期 | 稳定性 |
|--------|----------|--------|
| 2.19.4 | 2022-01 | ⭐⭐⭐⭐⭐ |
| 2.21.3 | 2022-06 | ⭐⭐⭐⭐⭐ |
| 2.23.4 | 2022-12 | ⭐⭐⭐⭐ |
| 2.24.7 | 2023-03 | ⭐⭐⭐⭐ |
| 2.25.4 | 2023-06 | ⭐⭐⭐⭐ |

## 💡 最佳实践

**开发环境：**
- 使用较老的基础库版本（如 2.19.4）
- 确保团队成员版本一致
- 在 manifest.json 中固定版本

**生产环境：**
- 使用较新的稳定版本
- 测试兼容性问题
- 关注微信官方公告

---

**当前已配置为 2.19.4，请重新运行试试！**

如果还是不行，请使用方案二：在微信开发者工具中手动设置基础库版本。