scrcpy：5分钟搭好安卓镜像与远程操控，延迟约40ms
项目地址: https://gitcode.com/GitHub_Trending/sc/scrcpy 想在会议室大屏上演示手机里的文档，或用键盘输入长段文字？scrcpy 通过 USB 或 Wi-Fi 将安卓设备屏幕镜像到电脑，鼠标、键盘操作可直接回传给手机，无需在手机上安装任何应用，延迟通常只有 35~70ms。
它是什么（一句话定位）
scrcpy 是开源的安卓镜像与远程操控工具：把设备画面（含音频）实时投屏到电脑，并把电脑的鼠标、键盘输入传回手机。它不做云同步、不管理文件、不做多端协作，只做镜像与控制这一件事。它不需要 root，不在手机上安装任何应用，运行时会注入一个临时 server 文件、退出后自动删除，设备上不留下痕迹。通信走系统级 ADB 通道，无账号、无广告、不需要联网。画面通常可达 1920×1080，帧率 30~120fps，视设备性能而定。
最短路径：跑起来
环境确认
先确认手机已开启 USB 调试，并检查电脑端 adb 能否识别设备。这条命令列出所有已连接设备：
adb devices
输出一行带设备序列号和 device 字样即正常；若列表为空，先检查数据线是否仅充电未传数据。安卓系统要求 5.0 及以上版本，音频转发则要求 11 及以上。
获取项目
把仓库克隆到本地。执行这条命令，会下载完整源码：
git clone https://gitcode.com/GitHub_Trending/sc/scrcpy
cd scrcpy
如果你已装好可用的 scrcpy（Linux 可用发行版包或官方发布包，Windows 与 macOS 参考平台文档），可跳过编译直接进入下一步。
首次运行
用 USB 连接手机，运行这条命令：
scrcpy
窗口打开后约 1 秒出现手机画面，在窗口内移动鼠标等同于触摸手机屏幕，右键会触发"返回"键。若同时连接了多台设备，终端会提示你用 --serial 指定目标。
按场景拆解功能
无线投屏脱离数据线
手机与电脑在同一 Wi-Fi 下，不想被线缆牵制。先用 USB 连好手机，运行：
scrcpy --tcpip
它会自动找到设备 IP、切换到无线模式后开始镜像，此后拔掉数据线仍可继续使用。
熄屏镜像省电
长时间投屏很耗电，而电脑侧仍需持续操作。启动时加上熄屏参数：
scrcpy --turn-screen-off
手机屏幕立即熄灭，但投屏画面与鼠标、键盘控制完全正常，适合"手机边充电边投屏"的场景。
多设备同时调试
手头有多台测试机同时接入，需要明确指向其中一台。先 adb devices 查序列号，再运行：
scrcpy --serial=<序列号>
每台设备各开一个独立窗口，方便并排对比不同安卓版本上的显示效果。
录制操作过程留档
复现 bug 或做教学演示，需要留下完整的操作记录。这条命令同时完成镜像与录制：
scrcpy --record=flow.mp4
关闭窗口即停止录制，mp4 文件保存在电脑本地；时间戳在设备端采集，不会因网络抖动而漂移。
常用配置一览
日常最常用的参数如下，均可在同一条命令中组合使用：
| 参数 | 作用 | 推荐值 | 适用场景 |
|---|---|---|---|
--max-size=1024 | 限制镜像视频的宽和高 | 1024 | 老机型、画面卡顿 |
--max-fps=30 | 限制屏幕捕获帧率 | 30 | 长时间投屏省电省带宽 |
--video-bit-rate=4M | 视频编码比特率 | 4M~8M | 画质与体积平衡 |
--video-codec=h265 | 改用 H.265 编码 | h265 | 同码率下画质更好 |
--audio | 转发设备音频 | 开启 | Android 11 及以上 |
--tcpip | 切换无线连接 | 不带参数 | 手机电脑同一网络 |
两条踩坑提醒：旧参数 --bit-rate 已在新版本中移除，继续使用会直接报错，请改用 --video-bit-rate；音频转发只在 Android 11 及以上版本生效，低版本加了参数也不会报错，只是没有声音。
排错
adb 显示 unauthorized 现象：连接后 adb devices 中设备状态为 unauthorized。 原因：手机端的 USB 调试授权对话框没有确认。 解法：在手机上勾选"始终允许使用这台计算机进行调试"后重插数据线；小米等机型还需在开发者选项里额外开启"USB 调试（安全设置）"。
能镜像但鼠标键盘无法操控 现象：画面正常显示，点击和按键却不生效。 原因：设备未授予输入事件注入权限，或开发者选项缺少安全调试开关。 解法：开启"USB 调试（安全设置）"后重启手机，再重新运行 scrcpy。
投屏卡顿、延迟高 现象：滑动画面有明显拖影，操作有滞后感。 原因：分辨率或比特率过高，超出 USB 或 Wi-Fi 的可用带宽。 解法：先用 --max-size=1024 降分辨率，再用 --max-fps=30 限帧率；USB 用户换一根支持 3.0 的数据线，效果通常立竿见影。
延伸资源
- 连接与无线设置细节：doc/connection.md
- 视频画质与分辨率参数：doc/video.md
- 快捷键完整列表：doc/shortcuts.md
- 客户端核心代码：app/src/
提交问题或参与代码贡献，参考 doc/develop.md。
下次要在手机上处理复杂内容时，先用 scrcpy 把它接到电脑上试试。一个免费、开源、无侵入的工具，就能覆盖投屏、远程操控与录屏的日常需求。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
