Escrcpy 完全指南：用图形化 scrcpy 把电脑变成 Android 多设备控制中心
【免费下载链接】escrcpy📱 Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpy
项目速览
Escrcpy 是一款基于 Electron 和 scrcpy 的图形化 Android 投屏与控制工具，专为嫌命令行麻烦的用户设计：插上手机，点一下"开始镜像"，就能用鼠标键盘操作手机，还能同时管多台设备。
核心能力拆解
Escrcpy 不只是 scrcpy 的"外壳"，它把投屏、控制、文件、网络等高频操作都收进了一个窗口里。
内嵌镜像与低延迟控制
核心基于 scrcpy，画面延迟低、性能高。镜像窗口自动适配手机分辨率与屏幕方向，窗口侧边栏集成了旋转、截图、音量、电源、通知中心等快捷操作，不用切菜单。
多设备群控
单窗口可同时镜像和控制多台设备，支持广播输入（电脑上的操作同步到所有手机）、批量截图、批量安装 APK、批量执行脚本。做应用兼容测试或账号矩阵运营的人，这一项基本是刚需。
无线连接与反向供网
- 扫码配对：手机开启无线调试后，用 Escrcpy 生成的二维码一键配对，拔掉线继续用；
- IP 直连：输入设备 IP 和端口（默认 5555）即可连接；
- Gnirehtet 反向供网：把电脑的网络共享给手机（Windows/Linux 内置，macOS 需手动安装）。
窗口编排与全局快捷键
主界面右上角的"窗口编排"提供全屏可视化编辑：拖拽设置每台设备的窗口位置、尺寸，保存布局后每次启动镜像自动套用。全局快捷键可自定义，在任意界面快速触发设备操作。
自动化脚本与 AI 操控
支持图形化逐步编排工作流，可带屏幕识图的条件判断，并在多台设备上批量执行；同时内置基于 MCP 协议的 Copilot 助手，支持多模型对话式的设备控制。相关实现分别在 desktop/electron/middleware/ 和 desktop/electron/modules/ 中。
快速跑起来
普通用户推荐直接下载安装包（Releases 发布页），以下源码方式适合想参与开发或尝鲜的版本。
- 安装 Node.js v20+ 和 Git；
- 克隆并安装依赖（项目使用 pnpm）：
git clone https://gitcode.com/GitHub_Trending/es/escrcpy cd escrcpy corepack enable pnpm pnpm install- 启动开发环境：
pnpm dev- 手机开启"开发者选项"和"USB 调试"，用数据线连接电脑，弹出授权提示点"允许"；
- 在设备列表中点击"开始镜像"，手机画面即出现在窗口中，可以直接开始操作。
实战场景演示
场景一：日常"隔空用手机"
连上镜像后，用电脑鼠标直接点按手机、键盘输入文字，把手机当第二块屏幕用。需要录屏时切换到录制模式，视频音频一键落盘，比手机自带录屏更好管理。偏好设置里还能按分辨率、码率、编码器微调画面质量，详见 docs/zhHans/guide/preferences.md。
场景二：多台手机批量验包
手上有 5 台手机要装同一个 APK 做兼容测试：设备列表里全选后执行"批量安装应用"，装完再"批量截图"核对首页效果，全程不用来回插线。想固定每台的窗口排布，用"窗口编排"拖好布局保存即可，参考 docs/zhHans/guide/window-arrangement.md。
场景三：手机没网，借电脑的网络
出差途中手机流量用完了，只要电脑有网：设备连上后，在控制栏点开 Gnirehtet 开关，手机立刻通过 USB 用上电脑的网络，测试环境、扫码支付这类场景很实用。
踩坑指南
| 现象 | 排查思路 |
|---|---|
| 电脑识别不到设备 | 重新插拔并确认已授权 USB 调试；仍不行多半是缺驱动，用驱动工具补装 |
| 有画面但点不动 | 小米等机型要额外开启"USB 调试（安全设置）"，允许模拟点击 |
| 无法输入中文 | 偏好设置 → 输入控制 → 键盘模式选uhid，手机装支持物理键盘的输入法（如微信输入法），电脑切英文输入后用Ctrl+Shift切换中英文 |
| 无线连接"积极拒绝访问" | 首次无线连接需先扫码配对；或先插 USB 建立授权再切无线 |
| adb / 镜像启动报错 | 多为 adb、scrcpy 路径错误，先重置偏好设置中的全局配置再试 |
adb start-server执行失败 | 安装路径含中文或特殊字符，改成纯英文路径 |
| macOS 打开提示"文件已损坏" | 未签名导致，执行sudo xattr -r -d com.apple.quarantine /Applications/Escrcpy.app修复 |
| 镜像画面卡顿 | 偏好设置里降低最大分辨率和视频比特率 |
更多排查细节可查 docs/zhHans/help/escrcpy.md。
延伸资料
- 上手文档：docs/zhHans/guide/started.md
- 设备操作指南（批量处理、控制模式、交互栏）：docs/zhHans/guide/operation.md
- 窗口编排详解：docs/zhHans/guide/window-arrangement.md
- scrcpy 参数参考（视频、音频、快捷键等）：docs/zhHans/reference/scrcpy/
- Gnirehtet 反向供网参考：docs/zhHans/reference/gnirehtet/
- 开发指南（构建、调试、贡献流程）：develop.md
- 快捷键模块源码：desktop/electron/services/shortcuts/
- 镜像与进程管理源码：desktop/electron/middleware/scrcpy/
【免费下载链接】escrcpy📱 Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpy
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
