Windows 安卓子系统（WSA）完整实操指南：安装、ADB 调试与报错排查

Windows 安卓子系统WSA完整实操指南安装、ADB 调试与报错排查【免费下载链接】WSADeveloper-related issues and feature requests for Windows Subsystem for Android项目地址: https://gitcode.com/gh_mirrors/ws/WSAWindows 安卓子系统WSA让 Windows 11 直接安装并运行安卓应用不占虚拟机的资源开销。本文面向开发者和进阶用户覆盖环境自检、安装步骤、ADB 调试配置与报错排查帮你在 10 分钟内跑通第一个安卓应用。适用人群画像30 秒判断 WSA 值不值得读如果你要在 PC 上调试安卓应用、不想每次测试都拉起模拟器那么本文的 ADB 连接与开发者模式配置会直接用到。如果你需要在大屏上跑只有手机版的应用银行、政务类工具那么重点看「WSA 快速安装步骤」和「WSA 报错排查手册」两节。如果你用的是 Windows 10 或纯虚拟机方案那么本文暂时帮不上忙WSA 只对本地 Windows 11 生效。WSA 环境自检清单5 项勾选按顺序勾选每条后面跟着不满足时怎么办Windows 11 且版本 ≥ 21H2按Win R输入winver查看。不满足 → 先升级系统WSA 不支持 Windows 10。64 位系统x64 或 ARM64设置-系统-关于中查看系统类型。不满足 → 需重装 64 位系统WSA 没有 32 位版本。虚拟化已启用任务管理器性能页签中查看虚拟化是否显示已启用。不满足 → 重启进 BIOSF2 或 Del把 VT-x / AMD-V 设为 Enabled。内存 ≥ 8GB、磁盘剩余 ≥ 25GB。不满足 → 先清理或扩容否则应用会因配额不足闪退。VirtualMachinePlatform与Microsoft-Windows-Subsystem-Linux两个功能已启用验证命令见下一节步骤 1。⚠️ 注意微软商店在 2025 年 3 月 5 日后下架了 WSA新设备无法再从商店安装需按下一节准备离线安装包。WSA 快速安装步骤3 步跑通最短路径步骤 1启用系统功能以管理员权限运行 PowerShellEnable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux预期结果两条命令均提示需要重新启动。随后执行Restart-Computer重启系统。步骤 2获取并安装 WSA 包从镜像仓库拉取安装包git clone https://gitcode.com/gh_mirrors/ws/WSA在目录中找到 WSA 的.appx文件右键选择以管理员身份运行。预期结果开始菜单能搜到 Windows Subsystem for Android且附带 Amazon Appstore。步骤 3首次启动验证打开 WSA 设置应用选择默认地区与语言再从 Appstore 装一个轻量应用。预期结果应用秒级进入首页Windows 任务栏出现对应图标划掉后资源占用同步回落。WSA 配置详解按使用场景分组场景 A日常装应用资源与显示配置项日常办公游戏 / 图形CPU 核心24~6内存4GB8~12GB图形模式硬件加速硬件加速在 WSA 设置中调整。日常使用 2 核 4GB 足够跑游戏时把核心数加到 4 以上图形模式保持硬件加速启动耗时可从 15 秒级压到 5 秒内。场景 B网络与局域网代理部分海外应用需要在 WSA 内单独配置代理Windows 系统代理不一定透传。局域网访问默认关闭。在开发者模式里打开本地网络访问或给单个应用单独授权应用才能发现同网段设备。Wi-Fi 与有线以太网均直通无需额外配置。场景 C开发者调试ADB在 WSA 设置中打开开发者模式。用本机 ADB 连接调试端口adb connect 127.0.0.1:58526 adb shell getprop ro.build.version.release第二条命令应输出13确认当前运行在 Android 13。 建议如果 58526 连不上先打开 WSA 设置查看实际显示的端口号它可能随重启变化以设置页为准。WSA 实战场景ADB 批量安装、文件共享与游戏场景 1批量安装 APK开发者输入5 个本地.apk文件合计约 300MB操作adb connect 127.0.0.1:58526 for %f in (*.apk) do adb install %f输出5 个包约 40 秒装完每个 6~8 秒adb shell pm list packages中应多出对应包名。场景 2共享文件夹直读大文件日常输入Windows 盘上一个 200MB 的 Excel 报表操作WSA 设置中开启共享用户文件夹在安卓应用里直接打开C:\Users下的原文件输出0 秒拷贝、0 份副本改完直接存回 Windows 目录对比先复制进安卓再导出的 50 秒以上往返耗时。场景 3键盘 手柄玩竞技游戏娱乐输入一款竞技手游WSA 配额设为 4 核 / 8GB / 硬件加速操作接入 USB 手柄WSA 原生支持 Gamepad帧率上限切到 60输出10 分钟对局平均 60fps、帧时间 16.7ms无掉帧告警鼠标键盘可同时接管输入。WSA 报错排查手册5 个高频症状症状安装报 0x80073CF9可能原因Windows 版本低于 21H2或步骤 1 的两个功能未生效解决动作winver确认版本 → 重新启用功能并重启 → 用管理员权限重跑安装包症状应用启动后闪退可能原因资源配额不足或应用版本过旧、不兼容 Android 13解决动作配额加到 4 核 8GB 重试换该应用最新版更新显卡驱动症状adb connect 127.0.0.1:58526 失败可能原因WSA 未运行或开发者模式未开启解决动作先启动 WSA 设置应用打开开发者模式按设置页显示的端口重连症状应用访问不到局域网设备可能原因本地网络访问默认处于关闭状态解决动作在开发者模式打开全局本地网络访问或按应用单独授权症状WSA 常驻资源占用偏高可能原因后台应用与视频解码仍在运行解决动作WSA 内划掉不用的应用把内存配额降回 4GB观察任务管理器曲线是否回落WSA 进阶与生态选读版本编号WSA 设置 → 关于页可见形如2207.40000.8.0的编号。提交开发 bug 时该编号必填维护团队按编号归档修复。提交问题先搜索既有 issue 避免重复bug 与功能请求分开提交后者需写清使用场景文档错误单独走 documentation 模板。功能现状已支持摄像头、麦克风、手柄、多显示器、WebView 与 Android 13文件传输、快捷方式、默认局域网访问仍在路线图上。提前体验新构建加入 Windows Insider 计划或注册 WSA Preview 计划使用与微软商店相同的 MSA 账号即可。 建议遇到文档没覆盖的疑难问题时先查社区 FAQ 与既有讨论再提交 issue能显著加快处理速度。核心收益与下一步三条核心收益免虚拟机的 Android 13 环境直接跑在 Windows 11 上与 Windows 共享文件、摄像头、手柄和多显示器标准 ADB 调试通道开发者工具链零改造接入下一步动作按环境自检清单完成重启然后执行adb connect 127.0.0.1:58526看到connected即算跑通。【免费下载链接】WSADeveloper-related issues and feature requests for Windows Subsystem for Android项目地址: https://gitcode.com/gh_mirrors/ws/WSA创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考