vscode开发android需同时安装android developer tools和gradle for java插件，配置jdk 17+，确保标准android项目结构、正确gradle配置及adb环境，否则无法运行调试。
装对插件：Kotlin插件 ≠ Android开发插件
VSCode 本身不原生支持 Kotlin 编译或 Android 构建，Kotlin 插件（如 fwcd.kotlin）只提供语法高亮和基础补全，**不能运行或调试 Android 项目**。真正需要的是 Android 开发链路的支撑。
必须同时安装：
-
Android Developer Tools（官方插件，提供adb集成、设备列表、Logcat 视图） -
Gradle for Java（用于识别和执行build.gradle.kts中的构建任务） - 确保系统已安装
jdk-17或jdk-21（Android Gradle Plugin 8.0+ 强制要求 JDK 17+）
别信“一个插件搞定 Kotlin+Android”的推荐——那是把 IDEA 的能力错配到 VSCode 上了。
项目结构必须是标准 Android 项目，不是纯 Kotlin 项目
VSCode 不会自动识别 src/main/kotlin 下的文件为 Android 应用入口。它依赖 settings.gradle.kts 和 build.gradle.kts 的存在与正确配置。
关键检查点：
- 根目录下有
gradlew（Linux/macOS）或gradlew.bat（Windows），且可执行 -
app/build.gradle.kts中包含plugins { id("com.android.application") } -
android { compileSdk = 34 }和defaultConfig { applicationId = "com.example.app" }已设置 - 没有删掉
app/src/main/AndroidManifest.xml—— VSCode 的 Android 插件靠它定位启动 Activity
如果只是新建了个 .kt 文件写了个 fun main()，那跑不起来，连模拟器都连不上。
adb 连接模拟器失败？先确认端口和权限
VSCode 的 Android Developer Tools 插件本质是调用 adb 命令。常见现象是设备列表为空，或显示 offline。
手动验证步骤：
- 终端运行
adb devices，看是否列出emulator-5554或类似设备名 - 如果没列出来，先启动模拟器（用 Android Studio 的 Device Manager 或命令行
emulator -avd Pixel_4_API_34） - 若仍不识别，检查环境变量：
ANDROID_HOME必须指向 Android SDK 根目录（如/Users/xxx/Library/Android/sdk），且platform-tools在PATH中 - Windows 用户注意：某些杀毒软件会拦截
adb.exe，临时禁用试试
VSCode 插件不会帮你修复 adb 路径问题，它只读取系统 PATH。
运行按钮灰色？Gradle 同步失败才是真因
VSCode 界面右上角的 ▶️ 按钮变灰，表面是“没可运行目标”，实际多因 Gradle 同步未完成或出错。
排查顺序：
- 打开命令面板（
Ctrl+Shift+P），运行Java: Reload Project—— 这会触发 Gradle sync - 观察输出面板中
Java或Gradle标签页，是否有Could not find method kotlin() for arguments类错误？说明build.gradle.kts里插件版本和 Kotlin 版本不匹配 - 检查
gradle/wrapper/gradle-wrapper.properties中的distributionUrl，AGP 8.4 要求 Gradle 8.6+，写成gradle-8.4-bin.zip就会卡住 - 首次同步可能耗时 2–5 分钟，不要急着关窗口——VSCode 不会弹进度条，但底部状态栏会显示 “Building workspace”
模拟器能连上，代码也能编译，不代表 VSCode 就知道该启动哪个 Activity。这个“知道”，靠的是 Gradle sync 后生成的 .vscode/settings.json 和插件缓存的模块信息。漏掉这步，后面全是空转。
