微信开发者工具

本地正常、真机异常

优先用真机调试查看 Network、Console 和 Storage。模拟器不能完整模拟授权、基础库差异、系统 WebView、网络限制和支付等能力。

检查顺序：

1. AppID、体验版账号和基础库版本是否正确。
2. 请求域名是否已在后台配置，HTTPS 证书与重定向是否有效。
3. 开发者工具“详情”中的本地设置是否与团队约定一致。
4. 使用 vConsole、远程调试或日志平台补充真机证据。

npm 构建后找不到模块

• 确认依赖安装在小程序项目实际使用的 package.json 所在目录。
• 执行“工具 → 构建 npm”，并在项目设置开启“使用 npm 模块”。
• 检查 miniprogram_npm 是否生成，以及组件 usingComponents 路径是否正确。
• 清缓存或重新构建前，先确认锁文件与构建目录没有被错误忽略。

基础库下载或工具网络异常

检查开发者工具代理、公司网络和登录状态；清理缓存后重试。不要长期依赖降低基础库版本绕过问题，应定位最低兼容版本与具体 API 差异。