VSCode 可作为完整 Kotlin IDE 使用：需配置 Kotlin CLI 编译环境、安装 Red Hat Kotlin 扩展+Code Runner+Gradle for Java、设置 JDK 并配置 launch.json 调试、通过 Gradle 实现多平台构建、支持 .kts 脚本直接执行。
如果您在使用 VSCode 编写 Kotlin 代码，却发现其功能仅被当作 Android 开发的附属工具，则可能忽略了它作为通用 Kotlin IDE 的完整潜力。以下是解锁 VSCode 全面支持 Kotlin 开发的关键路径：
本文运行环境：MacBook Air M2，macOS Sequoia。
一、配置 Kotlin 编译环境
VSCode 本身不内置 Kotlin 编译器，需借助外部工具链实现代码构建与执行。通过本地安装 Kotlin CLI 并正确配置路径，可使 VSCode 脱离 Android Studio 独立运行 Kotlin 脚本和 JVM 应用。
1、访问 https://github.com/JetBrains/kotlin/releases 下载最新版 kotlin-compiler.zip。
2、解压后将 bin/kotlinc 所在目录添加至系统 PATH。
3、在终端执行 kotlinc -version 验证安装成功。
二、安装核心扩展组合
单一扩展无法覆盖 Kotlin 的语法高亮、智能补全、调试、项目管理等全部需求，需协同启用多个经验证的扩展以构建完整开发流。
1、在 VSCode 扩展市场中搜索并安装 Kotlin Language Support by Red Hat（提供基础语言服务）。
2、安装 Code Runner，启用对 .kt 文件的单文件快速执行能力。
3、安装 Gradle for Java，用于识别和操作 build.gradle.kts 构建脚本。
三、启用 Kotlin/JVM 调试支持
调试是脱离 Android Studio 后必须重建的能力。通过配置 launch.json 使用 jdk + kotlin-reflect + kotlin-debugger，可实现断点、变量监视与步进执行。
1、确保已安装 JDK 17 或更高版本，并在 VSCode 中通过 Java Home 设置指向该 JDK。
2、在项目根目录创建 .vscode/launch.json，添加 type 为 java 的配置项。
3、在配置中指定 mainClass 为包含 main 函数的 Kotlin 类全限定名（如 com.example.HelloKt）。
四、构建多目标 Kotlin 项目
Kotlin 支持 JVM、JS、Native 多平台编译，VSCode 可通过 Gradle 插件与自定义 task 实现跨目标构建，无需切换 IDE。
1、初始化项目时使用 gradle init --type kotlin-library 创建基础结构。
2、在 build.gradle.kts 中添加 kotlin("multiplatform") 插件声明。
3、为 jvm() 和 js() 分别配置依赖与 sourceSets，运行 ./gradlew jvmJar 或 ./gradlew jsBrowserProductionWebpack 触发对应目标构建。
五、集成 Kotlin Script 运行环境
Kotlin Script（.kts）是轻量级自动化任务的理想载体，VSCode 可直接将其作为 shell 替代方案使用，适用于 DevOps 脚本、数据处理或 CI 工具链集成。
1、创建以 .kts 为后缀的文件，例如 deploy.kts。
2、在文件首行添加 shebang：#!/usr/bin/env kotlins。
3、赋予执行权限：chmod +x deploy.kts，随后可直接在终端运行 ./deploy.kts。
