Escrcpy 与 scrcpy 在 Windows 平台上的安装与运行完全指南

Escrcpy 与 scrcpy 在 Windows 平台上的安装与运行完全指南【免费下载链接】escrcpy Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpy本文以项目仓库 docs/zhHans/reference/scrcpy/windows.md 为骨架系统讲解基于 scrcpyv3.2构建的图形化 Android 投屏控制工具 Escrcpy 在 Windows 平台上的两种安装方式官方发布版压缩包与包管理器、命令行运行姿势、批处理脚本使用技巧并结合仓库源码剖析 Escrcpy 底层如何组织 scrcpy 进程与解析其输出。读完本文你将能够在 Windows 上从零装好 scrcpy、正确通过终端或脚本启动镜像并理解 Escrcpy 封装 scrcpy 的关键实现链路。背景scrcpy 是什么scrcpy发音为 screencopy是一个通过 USB 或 TCP/IP 连接镜像并控制 Android 设备的开源命令行工具支持视频与音频转发无需 root、无需在设备上安装应用可运行于 Linux、Windows 和 macOS。它也是 Escrcpy 的核心底层引擎Escrcpy 是 scrcpy 的图形化桌面客户端本仓库中的投屏、录制、摄像头、虚拟显示、应用列表枚举等能力均由对 scrcpy 命令行进程的封装而来。在阅读本文前请确保设备满足 前提条件Android 设备需至少支持 API 21Android 5.0音频转发需 Android 11并已在设备上启用 USB 调试。部分设备尤其是小米还需要在开发者选项中开启「USB 调试安全设置」才能注入键盘鼠标事件开启后需重启设备。在 Windows 上安装 scrcpy方式一下载官方发布版本访问 scrcpy 官方 releases 页面v3.2根据系统位数选择对应压缩包scrcpy-win64-v3.2.zip64 位SHA-256eaa27133e0520979873ba57ad651560a4cc2618373bd05450b23a84d32beafd0scrcpy-win32-v3.2.zip32 位SHA-2564a3407d7f0c2c8a03e22a12cf0b5e1e585a5056fe23c8e5cf3252207c6fa8357下载后解压即可使用无需安装步骤。建议核对压缩包 SHA-256 校验和防止下载损坏或文件被篡改Windows 下可用certutil -hashfile 文件 SHA256校验。压缩包内自带scrcpy.exe、adb.exe等组件解压目录即为 scrcpy 的工作目录。方式二通过包管理器安装Windows 下的主流包管理器均可安装 scrcpy其中 WinGet 会同时安装 ADB 与其他依赖# WinGet推荐自动带上 ADB 等依赖 winget install --exact Genymobile.scrcpy # Chocolatey choco install scrcpy choco install adb # 如果尚未安装ADB # Scoop scoop install scrcpy choco install adb # 如果尚未安装ADB注意原文档 Scoop 一节实际给出的命令为scoop install scrcpy与scoop install adb其中第二行笔误写成了choco实际应使用scoop install adb。使用包管理器安装后scrcpy命令会进入系统 PATH可在任意终端直接调用。如需手动从源码构建并安装可参阅 构建指南。在 Windows 上运行 scrcpyscrcpy 本质是一个命令行程序主要设计为通过终端带参数执行而非直接双击 GUI 启动。打开终端并执行命令解压后的 scrcpy 目录中包含一个open_a_terminal_here.bat文件双击它会在当前目录打开一个终端避免手动cd到解压目录的麻烦然后输入命令即可。不带任何参数启动镜像并显示设备屏幕、音频默认开启scrcpy带参数启动例如禁用音频并录制到file.mkvscrcpy --no-audio --recordfile.mkv命令行参数的完整文档可以通过scrcpy --help在本地查看也可以阅读本仓库的 scrcpy 用户文档 获取分主题说明连接、视频、音频、控制、键盘、鼠标、手柄、设备、窗口、录制、虚拟显示、隧道、OTG、摄像头、快捷键等。无需手动打开终端的启动方式若希望直接启动 scrcpy 而不用先开终端可双击以下文件之一scrcpy-console.bat启动时打开一个终端窗口scrcpy 正常终止后终端自动关闭发生错误时终端会保留以便查看报错scrcpy-noconsole.vbs启动时不显示任何终端窗口但错误信息也不可见。务必避免直接双击scrcpy.exe它被设计为从终端运行若发生错误控制台会瞬间关闭你根本来不及阅读错误信息。请使用scrcpy-console.bat作为替代。固定参数创建自己的 myscrcpy.bat如果你每次启动都要使用相同的参数组合可以创建一个myscrcpy.bat文件把命令写进去之后双击该文件即可。建议先在 Windows 中开启「显示文件扩展名」以免把.bat误存成.bat.txt。例如scrcpy --prefer-text --turn-screen-off --stay-awake上面这行命令的效果是优先使用文本注入而非剪贴板事件模拟键盘、镜像时关闭设备屏幕、保持设备不休眠。你也可以直接编辑或复制一份scrcpy-console.bat或scrcpy-noconsole.vbs在其命令末尾追加你需要的参数。源码视角Escrcpy 如何组织 scrcpy 进程Escrcpy 作为 scrcpy 的图形化封装其核心调用逻辑位于 desktop/electron/middleware/scrcpy/index.js。理解它有助于你在 Windows 上排查问题、理解参数来源。统一进程封装shellerEscrcpy 通过 desktop/electron/helpers/shell/index.js 中的sheller函数以spawn方式启动子进程并把它包装成兼具then/catch/finally的 Promise 对象同时提供kill()方法用于终止。createScrcpyProcess在此基础上拼接了形如scrcpy ${command}的整条命令行shell: true交由 shell 执行并支持通过正则readyPattern默认匹配Renderer:/Texture:/[server] INFO: Device:等输出判定「scrcpy 已就绪」从而在首帧画面出现时及时向 UI 层汇报。常用参数拼接与进程管理从源码可以看到 Escrcpy 实际使用的主要参数组合镜像mirror()拼接--serial${serial} --window-title${title}其中serial是设备序列号title是窗口标题录制record()追加--record${savePath}与文档示例scrcpy --no-audio --recordfile.mkv的录制语义一致无窗口辅助查询helper()固定追加--no-window --no-video --no-audio用于执行纯命令类查询避免弹出镜像窗口信息枚举--list-encoders编码器列表、--list-apps应用列表、--list-displays显示 ID 列表、--list-cameras摄像头列表输出解析逻辑见 desktop/electron/middleware/scrcpy/helper.js启动应用/虚拟显示launch()按需追加--new-display[尺寸]与--start-app${packageName}并通过正则New display:.?(id\d)捕获新创建的 display ID生命周期所有镜像进程统一注册进ProcessManager应用退出前通过quit-before事件调用kill()全部终止见 desktop/electron/process/manager.js 的注册入口。Windows 上 scrcpy 二进制的位置在 desktop/electron/process/helper.js 中可以看到Escrcpy 根据平台将 scrcpy、adb、gnirehtet 的二进制目录注入PATHWindows 平台统一使用extraResolve(win/scrcpy)即应用资源目录下的win/scrcpymacOS/Linux 则按平台-架构如mac-arm64/scrcpy区分。这意味着在 Escrcpy 的图形界面中即使系统 PATH 没有 scrcpy也能找到随应用分发的二进制同时setupToolEnv还会设置ADB、GNIREHTET_APK、SCRCPY_ICON_DIR、SCRCPY_SERVER_PATH等环境变量确保 scrcpy 能找到 adb 服务端与图标资源。如果你在终端手动运行scrcpy时遇到「不是内部或外部命令」说明 scrcpy 目录尚未加入 PATH请改用解压目录下的open_a_terminal_here.bat进入终端或参考上文包管理器方式安装。常用参数速查与组合示例结合文档与源码以下参数在 Windows 终端中均可直接使用参数作用scrcpy默认镜像显示屏幕 转发音频 双向控制--no-audio禁用音频转发--recordfile.mkv录制到指定文件可搭配--no-audio只录画面--serial序列号指定目标设备多设备时必用--prefer-text键盘注入优先使用文本方式--turn-screen-off镜像时关闭设备屏幕省电--stay-awake设备在镜像期间保持不休眠--shortcut-modrctrl更换快捷键修饰键默认是左 Alt 或左 Super即 Win/Cmd 键--max-size1920/-m1920限制画面分辨率显著提升性能--new-display1920x1080创建虚拟显示与设备主屏分离--start-app包名镜像时自动启动指定应用--list-apps/--list-displays/--list-cameras枚举设备信息Escrcpy 图形界面内部也在使用典型组合示例# 录制屏幕但不出声且降低分辨率提升流畅度 scrcpy --no-audio --recordfile.mkv -m1024 # 熄屏镜像并保持设备不休眠适合长时间挂机 scrcpy --turn-screen-off --stay-awake # 在新虚拟显示中启动 VLC scrcpy --new-display1920x1080 --start-apporg.videolan.vlc镜像窗口内的操作可通过快捷键完成例如MODf切换全屏、MODb或右键点击触发返回、MODo关闭设备屏幕等完整快捷键表见 快捷键文档。常见问题与排错思路双击scrcpy.exe后一闪而过、看不到报错这是设计使然。请改用scrcpy-console.bat启动或在open_a_terminal_here.bat打开的终端中运行才能看到错误输出。提示找不到 adb / 设备无权限确认设备已开启 USB 调试并授权WinGet 安装的版本已包含 ADB官方压缩包内亦自带adb.exe。键盘鼠标无法控制设备设备需满足 前提条件部分品牌尤其小米需额外开启「USB 调试安全设置」并重启设备。想固定参数又不想记命令把参数写进myscrcpy.bat双击即用这是原文档推荐的日常做法。总结在 Windows 上使用 scrcpy 的完整链路是官方压缩包或 WinGet/Chocolatey/Scoop 安装 → 通过open_a_terminal_here.bat打开终端 → 带参数运行scrcpy需要双击启动时使用scrcpy-console.bat/scrcpy-noconsole.vbs固定参数则沉淀为myscrcpy.bat。Escrcpy 正是在这条命令行链路上叠加了图形化封装——通过sheller统一管理 scrcpy 子进程、按平台注入二进制路径与环境变量、以正则解析--list-*系列输出最终呈现出开箱即用的投屏控制体验。掌握本文内容后你既能熟练地在 Windows 终端中独立驾驭 scrcpy也能理解 Escrcpy 图形界面背后每一处参数与脚本的由来。【免费下载链接】escrcpy Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考