manifest.json 的 libversion 仅声明最低基础库要求，真机运行以用户微信客户端实际基础库为准；需用 wx.getappbaseinfo().sdkversion 获取真实版本，结合 wx.caniuse 动态检测 api 兼容性，避免静默失败。
直接改 manifest.json 里的 libVersion 不起作用，真正生效的是微信客户端运行时的基础库版本，不是你本地调试工具设的值。
检查当前用户实际运行的基础库版本
用户手机上小程序用的是哪版基础库，取决于微信客户端版本 + 小程序后台配置，和你开发者工具里选的“调试基础库”完全无关。不能靠本地调低就以为兼容了。
- 真机调试时，用
wx.getAppBaseInfo().SDKVersion获取真实运行环境的基础库版本（注意：wx.getSystemInfo()在 ≤2.20.1 的旧基础库里才返回SDKVersion字段） - 别信字符串比较，比如
'2.3.0' > '2.29.1'是false—— 必须用数字分段比对，参考官方compareVersion函数 - 如果用户基础库是
2.10.4，而你用了uni.chooseMedia（要求 ≥2.25.0），那 API 直接不存在，调用会静默失败或报undefined
用 wx.canIUse 做运行时能力检测
比硬写版本号判断更可靠，也更符合微信推荐方式。它能识别 API、组件、属性、返回值字段等细粒度支持情况。
- 检测 API：
wx.canIUse('chooseMedia')或wx.canIUse('uploadFile.object') - 检测组件属性：
wx.canIUse('button.open-type.contact') - 不要只在
onLoad检测一次——某些 API（如蓝牙、地理位置）可能首次调用时才触发权限弹窗，需在调用前再 check 一遍 - 避免把
wx.canIUse写死在 data 里，它不是响应式，应放在方法内动态执行
manifest.json 中 libVersion 的真实作用
它只是声明「我这个小程序最低需要哪个基础库才能正常运行」，微信会在用户启动时做拦截：如果用户基础库低于该值，会直接提示「版本过低」并阻止进入，而不是让你代码去兜底。
- 配置位置：
"mp-weixin": { "setting": { "libVersion": "2.16.0" } } - 这个值必须 ≥ 项目中所有用到的 API 所要求的最低版本，否则上线后部分用户打不开
- 设太高会损失低版本用户；设太低又可能因 API 缺失导致逻辑崩溃——建议以你最依赖的那个新 API 的最低要求为准
- 注意：HBuilderX 项目中若未显式配置，uni-app 默认按当前 CLI 版本推荐值填充，但不会自动降级
真正容易被忽略的点是：基础库不兼容往往不报错，而是让 API 返回 undefined 或静默跳过。别只盯着控制台红字，要在关键路径加 console.log 或断点，确认函数是否真的执行了。
