VSCode配置Kotlin开发：安卓程序员的轻量级编辑器环境搭建-VSCode-PHP中文网

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。

vscode配置kotlin开发：安卓程序员的轻量级编辑器环境搭建

能跑 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 文件时连语法高亮都没有，更别说跳转或补全。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

在用户 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 这类模糊提示，实际卡在构建图解析阶段。