MuMu模拟器ADB连接失败主因是端口未手动连接及环境变量未配置，需将MuMu shell路径加入系统PATH，执行adb connect 127.0.0.1:16384，并确保开发者选项中USB调试已开启。
adb连不上MuMu模拟器？端口和环境变量是关键
很多开发者卡在“运行到android app基座”后模拟器没反应，根本不是项目问题，而是adb压根没连上模拟器。mumu默认用127.0.0.1:16384（v12版本），但这个端口必须手动连，hbuilderx不会自动帮你做。
- 先确认MuMu已开启“开发者选项”：进
设置 → 关于手机 → 版本号连点7次 - 再打开
设置 → 更多设置 → 开发者选项 → USB调试（有些版本叫“USB调试（安全设置）”，务必开） - 把
D:\Program Files\Netease\MuMu Player 12\shell加进系统PATH环境变量——不是用户变量，是系统变量；加完重启命令行和HBuilderX - cmd里执行
adb connect 127.0.0.1:16384（注意connect和IP之间有空格），看到connected to 127.0.0.1:16384才算成功 - 如果提示
already connected但HBuilderX仍不识别，试试adb kill-server && adb start-server重置adb服务
HBuilderX运行时找不到设备？检查基座兼容性
即使adb连上了，HBuilderX控制台显示Found 1 device，点击运行后模拟器还是黑屏或闪退，大概率是基座版本不匹配。HBuilderX每次大版本更新都会重构App基座逻辑，旧基座无法加载新编译的js包。
- 真机/模拟器首次运行时，HBuilderX会自动安装
HBuilder-Hello或uni-app Debug这类基座App；但如果之前装过旧版，它不会覆盖，而是静默失败 - 解决办法：在MuMu模拟器里手动卸载所有带
HBuilder、uni-app、Debug字样的App，再重新运行 - 运行后看HBuilderX控制台首行日志，确认
HBuilderX v3.9.12对应基座版本是否为v3.9.12（不是v3.8.x或unknown） - 若用自定义基座（比如集成了蓝牙插件），必须用同版本HBuilderX重新制作，否则白屏是必然结果
iOS模拟器没法直接跑uni-app？绕过Xcode是正解
uni-app官方不支持直接运行到iOS模拟器（如Simulator.app），因为没提供iOS版调试基座。你看到的“运行到iOS”选项，本质是打包成.ipa再拖进模拟器——这行不通，iOS模拟器只认Xcode构建的app。
- 真机调试iOS唯一可靠路径：Mac + Xcode + 真机 + 开启开发者账号+证书配置，耗时长且容易卡在签名环节
- 日常开发建议用HBuilderX的
运行到H5：点右上角预览按钮，在内置浏览器调试，console.log、DOM结构、样式实时生效，比iOS模拟器快十倍 - 如果非要看iOS视觉效果，导出
uni-app为H5项目，用Safari的开发 → iPhone Simulator模拟响应式视口（需开启Safari开发者菜单） - 别信“iOS模拟器插件”或“跨平台桥接工具”，它们无法真正调用
uni.getSystemInfo等原生API，测了也白测
调试时console.log不输出？检查运行模式和页面类型
改完代码点了运行，手机/模拟器里点按钮，HBuilderX控制台却没日志——不是代码错了，是运行模式或页面类型限制了日志通道。
-
vue页面的日志默认输出到HBuilderX底部控制台面板，无需点debug图标；但nvue页面必须点右下角debug图标才能看到console.log - 如果点了debug图标还看不到，检查是否误点了
运行到小程序：小程序模式下日志只进微信/支付宝开发者工具的Console，不会回传HBuilderX - 断点调试仅对
nvue页面生效（Sources里能打开uniapp目录下的文件），vue页面只能靠console.log或H5预览调试 - 真机调试时，
console.warn和console.error会被过滤，只有console.log稳定可见；生产环境这些全被屏蔽，别依赖它查逻辑
