VSCode能跑Kotlin代码、编译Android项目、调试App，但需显式对齐JDK、SDK、Gradle路径：确认JAVA_HOME与VSCode中java.home一致；在settings.json配置java.configuration.runtimes；设置ANDROID_SDK_ROOT及.vscode/settings.json中的android.sdkRoot；Android项目必须用Gradle任务（如assembleDebug）构建，不可依赖Code Runner。
能跑 Kotlin 代码、能编译 Android 项目、能调试 App —— 这三件事 VSCode 都能做到，但默认状态下它一个都做不到。关键不在装插件，而在 JDK、SDK、Gradle 三者路径的显式对齐。
确认 JDK 版本与 JAVA_HOME 是否真正生效
Android 开发要求 JDK 11 或 JDK 17（Kotlin 2.0+ 推荐 JDK 17），但 VSCode 不读系统 PATH，只认 JAVA_HOME 和设置里的显式路径。常见错误是终端里 java -version 显示 17，但 VSCode 仍报 Unsupported class file major version 61（对应 JDK 17）或直接找不到 JVM。
- 在 VSCode 终端中运行
echo $JAVA_HOME（macOS/Linux）或echo %JAVA_HOME%（Windows），输出必须是非空且指向 JDK 根目录（如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home） - 打开 VSCode 设置（
Cmd+,），搜索java.home，手动填入与JAVA_HOME一致的路径，不要用~或变量名 - 重启 VSCode —— 插件加载发生在启动时，改了环境变量不重启等于没改
安装 Kotlin 插件后必须配置 java.configuration.runtimes
VSCode 的 Kotlin 支持依赖 Java 扩展包（Extension Pack for Java），而该扩展不会自动复用 java.home。它用独立的 java.configuration.runtimes 列表管理 JDK 映射，否则新建 .kt 文件时连语法高亮都没有，更别说跳转或补全。
- 在用户 settings.json 中添加：
{ "java.configuration.runtimes": [ { "name": "JavaSE-17", "path": "/path/to/jdk-17" } ] } -
name必须严格匹配 Gradle 构建脚本中的sourceCompatibility（如java { sourceCompatibility = JavaVersion.VERSION_17 }），否则编译时报Unsupported target value '17' - 如果同时开发 Java 和 Kotlin 模块，建议把 JDK 8/11/17 全部列进去，避免切换项目时反复修改
Android SDK 路径必须被 Gradle 插件和命令行工具同时识别
VSCode 本身不运行 adb 或 aapt，它靠 Android 插件和 Gradle Language Support 解析 build.gradle。一旦 ANDROID_SDK_ROOT 或 ANDROID_HOME 没对上，就会出现 Failed to find target with hash string 'android-33' 或 Could not find method android() for arguments 这类错误。
- 确保系统级环境变量
ANDROID_SDK_ROOT已设置（推荐，比ANDROID_HOME更可靠），值为 SDK 根目录（如/Users/you/Library/Android/sdk） - 在项目根目录的
.vscode/settings.json中补充：{ "gradle.javaHome": "/path/to/jdk-17", "android.sdkRoot": "/path/to/android/sdk" } - 运行
sdkmanager --list_installed确认已安装platforms;android-33、build-tools;33.0.2、platform-tools—— Gradle 插件不会自动帮你装缺的组件
运行 Kotlin Android 项目不能只靠「Run Code」按钮
VSCode 自带的 Code Runner 插件对 Kotlin 支持仅限 JVM 脚本（fun main()），完全无法处理 Android 的 Application 生命周期、资源编译、APK 打包等流程。点「运行」只会报 Exception in thread "main" java.lang.NoClassDefFoundError: android/app/Application。
- 正确方式是用 Gradle 任务：按
Cmd+Shift+P→ 输入Gradle: Run Task→ 选assembleDebug生成 APK，再用adb install手动安装 - 要调试，必须配置
.vscode/launch.json使用Android Debug Bridge启动模式，而非默认的java类型 - 如果想一键部署到设备，需在
tasks.json中定义复合任务，顺序执行assembleDebug+adb install+adb shell am start
最易被忽略的是 Gradle Wrapper 版本与 Kotlin 插件版本的隐式耦合 —— gradle-8.4 要求 org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.20，而 Android Gradle Plugin 8.4 又强制绑定 Kotlin 1.9.x。三者 mismatch 时，VSCode 控制台只显示 Configuration cache may not be supported 这类模糊提示，实际卡在构建图解析阶段。
