要在 VSCode 中配置 Kotlin 开发环境，需依次安装 Kotlin 插件、Temurin JDK 17+、Gradle（JVM）或 Android Studio SDK（Android），配置 Java 扩展与 launch.json，并解决编译识别问题。
如果您希望在 Visual Studio Code 中进行 Kotlin 开发，无论是面向 JVM 还是 Android 平台，都需要正确配置语言支持、构建工具与运行环境。以下是完成该配置的具体步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Kotlin 插件与基础工具链
VSCode 本身不内置 Kotlin 支持，需通过扩展提供语法高亮、代码补全与基本诊断功能。同时需确保本地已安装 Kotlin 编译器及 Java 运行环境，这是所有 Kotlin 项目的基础依赖。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 Kotlin Language，选择由 fwcd 发布的官方推荐扩展并安装。
3、访问 https://adoptium.net/ 下载并安装 Temurin JDK 17 或更高版本。
4、在终端执行 kotlinc -version 验证 Kotlin 编译器是否可用；若提示命令未找到，需将 kotlinc 所在路径加入系统 PATH。
二、配置 JVM 项目（使用 Gradle）
JVM 项目依赖 Gradle 构建系统管理依赖与编译流程。VSCode 通过 Gradle Tasks 和 Java Extension Pack 实现任务识别与调试支持。
1、在项目根目录执行 gradle init --type kotlin-application 初始化标准 Kotlin JVM 工程。
2、在 VSCode 中打开项目文件夹，安装 Extension Pack for Java（由 Microsoft 提供）。
3、打开命令面板（Cmd+Shift+P），输入并执行 Java: Configure Classpath，确保 Kotlin 标准库被识别为源路径。
4、在 .vscode/settings.json 中添加：
"java.configuration.updateBuildConfiguration": "interactive"。
三、配置 Android 开发环境
Android 开发无法仅靠 VSCode 原生支持完成，需借助 Android Studio 提供的 SDK 与构建能力，并在 VSCode 中启用有限的编辑与调试协同。
1、下载并安装 Android Studio Giraffe，完成 SDK Platform-Tools、Build-Tools 34.x 及 Android API 34 的安装。
2、在终端中运行 sdkmanager --list_installed 确认 SDK 路径已就绪，记录 ANDROID_HOME 值。
3、在 VSCode 中安装 Android SDK Tools 扩展（由 mattiaferrario 提供），并在设置中填入 android.sdkPath 指向 SDK 根目录。
4、在项目根目录创建 local.properties 文件，写入：
sdk.dir=/Users/yourname/Library/Android/sdk（路径需替换为实际 SDK 路径）。
四、启用 Kotlin 调试支持
调试能力依赖 Java 调试适配器与 launch.json 配置，需区分 JVM 应用与 Android Instrumented Test 的不同启动方式。
1、在项目根目录创建 .vscode/launch.json 文件。
2、为 JVM 主类添加配置项：
"type": "java", "request": "launch", "mainClass": "com.example.AppKt"。
3、对 Android 测试类，使用 "type": "android" 类型（需已安装 Android Debug extension）并指定 "activity": "MainActivity"。
4、按下 Ctrl+F5 启动调试会话，确认控制台输出与断点命中行为正常。
五、解决常见编译识别失败问题
VSCode 可能无法自动识别 Kotlin 源码位置或模块依赖关系，导致无补全、红色波浪线或 unresolved reference 错误。
1、在项目根目录执行 ./gradlew clean compileKotlin 强制生成 class 文件与 stubs。
2、在 VSCode 中执行命令 Java: Clean the Java language server workspace 并重启窗口。
3、检查 build.gradle.kts 中是否声明了 kotlin("jvm") 插件及对应版本。
4、若使用多模块结构，在 settings.gradle.kts 中确认所有子项目均已 include。
