基础库版本问题解决方案

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

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

配置位置： manifest.json

"mp-weixin" : {
    "libVersion" : "2.19.4"
}

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

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

步骤：

打开微信开发者工具
点击右上角"详情"
选择"本地设置"标签
勾选"不使用体验版基础库"

选择任意可用的基础库版本（如 2.24.7、2.23.4 等）

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

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

可能的原因：

网络连接问题
公司防火墙限制
需要代理

解决方法：

检查网络连接
```
ping developers.weixin.qq.com
```
配置代理（如果需要）
- 微信开发者工具 → 设置 → 代理设置
- 使用系统代理或自定义代理
关闭防火墙临时测试

📱 方案四：使用真机调试

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

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

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

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

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

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

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

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

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

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

🎯 推荐操作顺序

✅ 先用方案一（已配置 2.19.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，请重新运行试试！

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

BASE_LIBRARY_FIX.md 3.9 KB История Директен файл