VSCode本身不支持直接安装或创建Android模拟器，AVD必须通过Android Studio安装SDK后由emulator可执行文件驱动；VSCode仅能通过ADB连接已启动的模拟器，需正确配置ANDROID_HOME和platform-tools路径，并手动刷新设备列表。
VSCode 本身不支持直接安装或创建 Android 模拟器
模拟器（AVD）不是 VSCode 的功能组件，它由 emulator 可执行文件驱动，而该文件属于 Android SDK 的 emulator 子目录，必须通过 Android Studio 安装完整 SDK 后才能获得。VSCode 插件无法下载系统镜像、生成 AVD 配置文件（~/.android/avd/xxx.avd/），也不能启动图形化模拟器界面。
你真正需要的是：先用 Android Studio 完成 AVD 创建和首次启动，再让 VSCode 通过 ADB 连接已运行的设备。
- Android Studio 必须安装（哪怕只用来初始化模拟器）
- 确保已安装对应 API 级别的
system-images（例如system-images;android-34;google_apis;x86_64） - 不要尝试在 VSCode 里“新建 AVD”——所有相关插件（如
Android Tools for VS Code）调用的仍是 Android Studio 生成的配置
必须手动配置 ANDROID_HOME 和 platform-tools 路径
VSCode 的 Android 插件（如 Android Tools for VS Code 或官方 Android Development）依赖环境变量定位 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 不调用它来启动模拟器（仅部分插件支持“启动 AVD”菜单项，本质仍是 shell 调用） - 插件设置页里填的
adb.path必须指向adb文件本身（如/path/to/platform-tools/adb），不是目录
连接已启动的模拟器：adb connect 不适用，要用 adb devices 自动识别
模拟器启动后（无论用 Android Studio 还是命令行 emulator -avd Pixel_4_API_34），VSCode 并不会自动刷新设备列表。你得手动触发设备发现，或依赖插件的“Refresh Devices”按钮。
常见错误现象：
-
adb devices输出为空，但模拟器窗口已打开 → 检查adb server是否被第三方工具（如夜神、雷电）占用了 5037 端口 - 设备显示为
offline→ 模拟器尚未完成 boot，等 2–3 分钟再试；或执行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/Java 文件
- 右键设备选择“Install APK”（需手动指定路径）
- 用
Android Tools for VS Code的 “Run on Device” 命令（本质是执行上述 adb install）
真正的瓶颈不在模拟器连接，而在构建链路——VSCode 没有 Android Studio 那套构建上下文感知能力，build.gradle.kts 里的 applicationId、compileSdk 错了，它不会提示你应用根本启不来。
