Mac端Android Studio连接Realme Android13无线调试失败求助

前提准备 #

• 手机和Mac连同一Wi-Fi网络（必须是2.4G/5G同一频段，Realme双Wi-Fi功能会干扰，建议暂时关闭）
• 开启手机开发者选项：设置>关于手机>连续点7次版本号，返回设置找到「开发者选项」
• 开发者选项里打开「无线调试」「USB调试」（别嫌麻烦，USB调试开着能规避不少权限坑）
• Mac端Android Studio更到最新稳定版，SDK Platform Tools更到33.0.3以上（去SDK Manager里检查更新）

优先方案：配对码手动操作（比QR扫描稳定10倍） #

1. 手机开无线调试，选「配对设备配对码」，把屏幕上的配对码、IP地址、配对端口记下来（注意是配对端口，不是后面的调试端口，一般是300开头的数）
2. Mac开终端，进到SDK Platform Tools目录，默认路径是~/Library/Android/sdk/platform-tools/，直接复制路径进去就行
3. 输命令：adb pair [IP地址]:[配对端口]，回车后输入刚才的配对码，看到「Successfully paired」就配对成了
4. 接着输连接命令：adb connect [IP地址]:[调试端口]（调试端口在手机无线调试的「已配对设备」里能看到，一般是5555/5556）
5. 切回Android Studio的「设备管理器」，就能看到你的Realme设备了

QR扫描方式优化（实在想用的话） #

1. 手机开无线调试，选「配对设备QR码」
2. Mac端如果设备管理器的QR按钮不显示，重启Android Studio再打开设备管理器
3. 扫码前关掉手机的护眼模式「色彩校正」——Realme的色彩滤镜会让QR码识别失效
4. 扫码时保持10-20cm距离，光线够亮，别反光
5. 要是扫码没反应，先插USB连一次手机，终端输adb tcpip 5555，拔了USB再扫QR码

常见坑排查 #

• 配对码方式找不到设备：检查Mac防火墙，去系统设置>网络>防火墙，允许「adb」和「Android Studio」的网络权限
• TCP端口过期：每次开无线调试，配对端口都会刷新，必须用当前屏幕显示的，别拿上次的旧端口凑数
• 连接失败：重启手机的开发者选项（关了再开），Mac端重启adb服务：终端输adb kill-server再adb start-server
• Realme专属坑：关掉手机的「隐私替身」，去应用权限管理里给「无线调试」开全权限，部分机型还要额外开「允许通过Wi-Fi调试」的开关

终极备用方案（稳得一批） #

1. 用USB线把手机连到Mac，终端输adb devices确认能识别设备（显示设备ID就行）
2. 输adb tcpip 5555，然后拔掉USB线
3. 手机看当前Wi-Fi的IP：设置>Wi-Fi>点当前网络>看详情里的IP地址
4. Mac终端输adb connect [手机IP]:5555，连接成功后，以后同一Wi-Fi下直接输这个命令就能连

内容的提问来源于stack exchange，提问作者Rishabh Aggarwal