如何在VSCode安装完毕后配置 Android 开发模拟器

先得说清楚一个核心问题：VSCode本身不支持直接安装或创建Android模拟器。很多新手容易在这上面绕弯子，总以为装了插件就能“新建一个A VD”，其实不是这么回事。

模拟器（A VD）不是VSCode的功能组件，它由 emulator 可执行文件驱动，而这个文件属于Android SDK的 emulator 子目录，必须通过Android Studio安装完整的SDK才能获得。VSCode插件既不能下载系统镜像，也不能生成A VD配置文件（也就是 ~/.android/a vd/xxx.a vd/ 那一套），更不可能启动图形化的模拟器界面。

所以，你真正需要做的事情是：先用Android Studio完成A VD的创建和首次启动，然后让VSCode通过ADB连接这个已经运行的设备。Android Studio是必须安装的——哪怕你只用它来初始化模拟器。同时要确保对应API级别的 system-images 已经装好，比如 system-images;android-34;google_apis;x86_64 这个。千万别在VSCode里琢磨“新建A VD”，所有相关插件（比如 Android Tools for VS Code）调用的仍然是Android Studio生成的配置。

必须手动配置 ANDROID_HOME 和 platform-tools 路径

VSCode的Android插件依赖环境变量来定位ADB和emulator。如果路径配错了，adb devices 就会给你报 command not found，或者干脆连接超时。以macOS/Linux为例，关键路径是这样配置的：

export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator

Windows用户需要在系统环境变量里设置 ANDROID_HOME，然后在 Path 中添加 %ANDROID_HOME%\platform-tools 和 %ANDROID_HOME%\emulator。注意几个关键点：platform-tools 提供 adb，负责设备通信；emulator 目录提供 emulator 命令，但VSCode通常不直接调用它来启动模拟器（部分插件的“启动A VD”菜单项，本质还是通过shell调用）。还有，插件设置页里填的 adb.path 必须指向 adb 文件本身，比如 /path/to/platform-tools/adb，而不是填目录。

连接已启动的模拟器：adb connect 不适用，用 adb devices 自动识别

模拟器启动之后——不管是用Android Studio还是命令行 emulator -a vd Pixel_4_API_34——VSCode并不会自动刷新设备列表。你得手动触发设备发现，或者点击插件的“Refresh Devices”按钮。一些常见的错误现象值得留意：

• adb devices 输出为空，但模拟器窗口已经打开了。这时候要检查 adb server 是否被第三方工具（比如夜神、雷电模拟器）占用了5037端口。
• 设备显示为 offline。这通常表示模拟器还没完成boot过程，等个两到三分钟再试；或者执行 adb kill-server && adb start-server 重置一下连接。
• 设备显示为 unauthorized。这个原因多半是模拟器弹出的授权对话框没点“Allow”，或者USB调试没开启——对模拟器来说这一步通常不需要，但某些镜像会有例外。

Flutter用户尤其要注意：flutter devices 依赖的是同一套ADB系统，如果它不显示设备，说明底层连接已经断了，没必要单独去排查Flutter的问题。

调试 Android 应用仍需外部构建，VSCode 不提供 Run 按钮

即便模拟器连上了、Logcat能看了，VSCode也无法一键编译APK并安装。它没有Gradle Daemon管理能力、APK签名逻辑，也不具备 AndroidManifest.xml 变更监听的能力。一个最小可行的流程是在终端里执行：

./gradlew assembleDebug
adb install -r app/build/outputs/apk/debug/app-debug.apk
adb logcat *:S ActivityManager:I MyApp:D

插件能帮你做的，主要是这些辅助工作：点击Logcat输出中的日志行跳转到对应的Kotlin/Ja va文件；右键设备选择“Install APK”（需要手动指定路径）；或者用 Android Tools for VS Code 的 “Run on Device” 命令——本质上是帮你执行上面的 adb install。

真正需要理解的是，瓶颈不在模拟器连接，而在构建链路。VSCode没有Android Studio那套构建上下文感知能力，build.gradle.kts 里的 applicationId 或者 compileSdk 写错了，它不会给你任何提示，应用根本起不来你也不知道。所以，做好心理准备：VSCode是个优秀的编辑器，但在Android开发的全流程里，它只负责编辑和调试的“最后一公里”，前面的构建工作还是得靠终端和Gradle。