纸白微明，未成篇章。

风过空庭，字句正徐来。

Mac 通过无线 ADB 连接 Android 手机，并在电脑预览手机画面

这篇教程介绍如何在 macOS 上通过无线 ADB 连接 Android 手机，并使用 scrcpy 在电脑上实时预览和控制手机画面。

适合场景：

调试 Android App
调试手机 H5 / WebView
在电脑上预览手机画面
用鼠标键盘操作手机
截图、录屏、查看日志、安装 APK

一、准备条件

手机需要满足：

Android 11 或以上
已开启开发者选项
已开启无线调试
手机和电脑连接同一个 Wi-Fi

电脑需要安装：

adb
pipx
adb-wifi-py
scrcpy

二、安装 ADB

macOS 推荐使用 Homebrew 安装 Android Platform Tools。

brew install android-platform-tools

CodeBlock Loading...

安装完成后检查 ADB 是否可用：

adb version

CodeBlock Loading...

能看到版本信息，表示安装成功。

三、开启手机开发者选项

手机进入：

设置 → 关于手机 → 连续点击「版本号」7 次

CodeBlock Loading...

然后返回设置，进入：

设置 → 开发者选项

CodeBlock Loading...

打开下面几个开关：

USB 调试
无线调试

CodeBlock Loading...

部分国产 Android 手机还需要打开：

USB 调试（安全设置）
允许通过 USB 安装应用
默认 USB 配置：文件传输 / MTP

CodeBlock Loading...

四、安装二维码无线连接工具

这里使用 adb-wifi-py，它可以在终端生成二维码，手机在无线调试页面扫码完成配对。

先安装 pipx：

brew install pipx
pipx ensurepath
exec zsh

CodeBlock Loading...

然后安装 adb-wifi-py：

pipx install adb-wifi-py

CodeBlock Loading...

检查命令是否可用：

adb-wifi --help

CodeBlock Loading...

五、通过二维码无线连接手机

电脑终端执行：

adb-wifi

CodeBlock Loading...

终端会显示一个二维码。

手机进入：

设置 → 开发者选项 → 无线调试 → 使用二维码配对设备

CodeBlock Loading...

用手机扫描电脑终端里的二维码。

配对成功后，在电脑上执行：

adb devices

CodeBlock Loading...

正常会看到类似结果：

List of devices attached
192.168.1.23:42123    device

CodeBlock Loading...

其中：

192.168.1.23:42123

CodeBlock Loading...

就是手机的无线 ADB 地址。

六、无线 ADB 连接成功后怎么用

无线连接成功后，使用方式和 USB 数据线连接一样。

查看设备：

adb devices

CodeBlock Loading...

进入手机 Shell：

adb shell

CodeBlock Loading...

查看手机型号：

adb shell getprop ro.product.model

CodeBlock Loading...

查看 Android 版本：

adb shell getprop ro.build.version.release

CodeBlock Loading...

安装 APK：

adb install app.apk

CodeBlock Loading...

覆盖安装 APK：

adb install -r app.apk

CodeBlock Loading...

卸载 App：

adb uninstall 包名

CodeBlock Loading...

查看已安装包：

adb shell pm list packages

CodeBlock Loading...

按关键词查包名：

adb shell pm list packages | grep 关键词

CodeBlock Loading...

启动 App：

adb shell monkey -p 包名 1

CodeBlock Loading...

清除 App 数据：

adb shell pm clear 包名

CodeBlock Loading...

查看日志：

adb logcat

CodeBlock Loading...

清空日志：

adb logcat -c

CodeBlock Loading...

按关键词过滤日志：

adb logcat | grep 关键词

CodeBlock Loading...

七、让手机访问电脑本地服务

比如电脑启动了一个前端项目：

pnpm dev

CodeBlock Loading...

服务端口是 3000。

执行端口映射：

adb reverse tcp:3000 tcp:3000

CodeBlock Loading...

然后手机浏览器访问：

http://127.0.0.1:3000

CodeBlock Loading...

这样手机就可以访问电脑本地的前端服务。

这个方式很适合调试：

H5 页面
WebView 页面
React / Vue / Next.js 本地页面
React Native 本地服务
Flutter 本地接口

如果接口端口是 8080，可以继续映射：

adb reverse tcp:8080 tcp:8080

CodeBlock Loading...

手机访问：

http://127.0.0.1:8080

CodeBlock Loading...

八、安装 scrcpy 预览手机画面

scrcpy 用来把手机画面投到电脑上。它基于 ADB 连接工作，支持 USB 和无线 ADB 连接。

macOS 安装：

brew install scrcpy

CodeBlock Loading...

安装完成后执行：

scrcpy

CodeBlock Loading...

如果当前只有一台 ADB 设备在线，会直接弹出手机画面窗口。

九、无线投屏预览手机画面

先确认无线 ADB 已连接：

adb devices

CodeBlock Loading...

看到类似结果：

List of devices attached
192.168.1.23:42123    device

CodeBlock Loading...

然后启动 scrcpy：

scrcpy

CodeBlock Loading...

启动后可以直接在电脑上：

查看手机画面
用鼠标点击手机
用键盘输入文字
拖动页面
操作 App

十、scrcpy 常用命令

只预览画面，禁止电脑控制手机：

scrcpy --no-control

CodeBlock Loading...

降低分辨率，提升流畅度：

scrcpy -m 1024

CodeBlock Loading...

录制手机画面到电脑：

scrcpy --record demo.mp4

CodeBlock Loading...

指定设备启动：

scrcpy -s 手机IP:端口

CodeBlock Loading...

示例：

scrcpy -s 192.168.1.23:42123

CodeBlock Loading...

息屏投屏：

scrcpy --turn-screen-off

CodeBlock Loading...

退出 scrcpy：

关闭窗口

CodeBlock Loading...

或者在终端按：

Ctrl + C

CodeBlock Loading...

十一、多设备场景

如果同时连接了 USB 和无线设备，先查看设备列表：

adb devices

CodeBlock Loading...

示例：

List of devices attached
emulator-5554           device
192.168.1.23:42123     device

CodeBlock Loading...

指定无线设备进入 Shell：

adb -s 192.168.1.23:42123 shell

CodeBlock Loading...

指定无线设备安装 APK：

adb -s 192.168.1.23:42123 install -r app.apk

CodeBlock Loading...

指定无线设备启动 scrcpy：

scrcpy -s 192.168.1.23:42123

CodeBlock Loading...

十二、截图和录屏

截图到手机：

adb shell screencap -p /sdcard/screen.png

CodeBlock Loading...

拉取截图到电脑：

adb pull /sdcard/screen.png ./

CodeBlock Loading...

录屏到手机：

adb shell screenrecord /sdcard/demo.mp4

CodeBlock Loading...

按 Ctrl + C 停止录制。

拉取录屏到电脑：

adb pull /sdcard/demo.mp4 ./

CodeBlock Loading...

也可以直接用 scrcpy 录屏到电脑：

scrcpy --record demo.mp4

CodeBlock Loading...

十三、常见问题

1. pipx: command not found

说明电脑还没有安装 pipx。

执行：

brew install pipx
pipx ensurepath
exec zsh

CodeBlock Loading...

然后重新安装：

pipx install adb-wifi-py

CodeBlock Loading...

2. adb devices 看不到手机

检查手机和电脑是否在同一个 Wi-Fi。

然后检查手机：

设置 → 开发者选项 → 无线调试

CodeBlock Loading...

确认无线调试已经打开。

电脑执行：

adb kill-server
adb start-server
adb devices

CodeBlock Loading...

3. adb devices 显示 unauthorized

手机还没有授权当前电脑。

执行：

adb kill-server
adb start-server
adb devices

CodeBlock Loading...

然后看手机是否弹出授权窗口，选择允许。

4. adb devices 显示 offline

重启 ADB：

adb kill-server
adb start-server
adb devices

CodeBlock Loading...

也可以关闭手机无线调试后重新打开，再重新扫码连接。

5. scrcpy 打不开

先确认 ADB 能看到设备：

adb devices

CodeBlock Loading...

如果有多台设备，指定设备：

scrcpy -s 手机IP:端口

CodeBlock Loading...

如果无线连接延迟较高，可以降低分辨率：

scrcpy -m 1024

CodeBlock Loading...

6. 手机访问不了电脑本地页面

先确认电脑服务是否启动：

curl http://127.0.0.1:3000

CodeBlock Loading...

然后重新做端口映射：

adb reverse tcp:3000 tcp:3000

CodeBlock Loading...

手机浏览器访问：

http://127.0.0.1:3000

CodeBlock Loading...

十四、推荐日常使用流程

每天开发前执行：

adb-wifi

CodeBlock Loading...

手机扫码连接后，确认设备：

adb devices

CodeBlock Loading...

映射本地前端服务：

adb reverse tcp:3000 tcp:3000

CodeBlock Loading...

打开手机画面预览：

scrcpy

CodeBlock Loading...

查看日志：

adb logcat | grep 关键词

CodeBlock Loading...

常用完整流程：

adb-wifi
adb devices
adb reverse tcp:3000 tcp:3000
scrcpy

CodeBlock Loading...

推荐把 adb + adb-wifi-py + scrcpy 作为 Android 真机调试的基础工具链：

adb：负责连接、安装、日志、调试
adb-wifi-py：负责二维码无线配对
scrcpy：负责电脑预览和控制手机画面