VSCode可支持Kotlin跨平台及Android开发,但需手动配置:安装Kotlin插件、JDK与kotlinc;用Gradle模板初始化KMM项目;配置Android SDK与ADB插件;分别设置CodeLLDB和Java Debugger进行多目标调试;复杂场景可借助Projector远程连接IntelliJ IDEA。

如果您希望使用轻量级编辑器进行 Kotlin 跨平台及 Android 开发,VSCode 提供了灵活的扩展生态与快速启动体验,但需手动配置语言支持、构建工具链和调试环境。以下是实现该目标的具体操作路径:
本文运行环境:MacBook Air M2,macOS Sequoia。
一、安装 Kotlin 插件与基础工具链
Kotlin 语言支持依赖插件提供语法高亮、代码补全与基本诊断能力,而编译与运行需本地安装 Kotlin 编译器(kotlinc)及 JDK。VSCode 本身不内置 Kotlin 运行时,必须通过扩展桥接外部工具。
1、打开 VSCode 扩展市场,搜索并安装 Kotlin Language(由 fwcd 发布)。
2、在终端执行 brew install openjdk@21 安装 JDK 21,并设置 JAVA_HOME 环境变量指向该路径。
3、执行 curl -s "https://get.sdkman.io" | bash 安装 SDKMAN,随后运行 sdk install kotlin 获取 kotlinc 命令行编译器。
二、配置跨平台项目(KMM 或 Kotlin Multiplatform)
Kotlin Multiplatform 项目需 Gradle 构建脚本定义多目标(JVM、JS、Native),VSCode 通过 Gradle Tasks 扩展识别并执行构建流程,但不提供图形化项目向导,须基于已有模板初始化。
1、在终端中进入目标目录,运行 mkdir mykmp && cd mykmp 创建空项目根目录。
2、执行 curl -s https://raw.githubusercontent.com/JetBrains/kotlin/master/libraries/tools/kotlin-gradle-plugin/src/main/resources/templates/multiplatform-template/build.gradle.kts -o build.gradle.kts 下载官方 KMP 模板脚本。
3、在 VSCode 中打开该文件夹,按 Cmd+Shift+P 调出命令面板,输入 Gradle: Refresh Projects 并执行,使插件识别 Gradle 结构。
三、启用 Android 开发支持
VSCode 不原生支持 Android Studio 的 AVD 管理或布局预览,但可通过插件调用命令行工具链完成编译、安装与日志查看,前提是已安装 Android SDK 和 platform-tools。
1、下载并解压 Android Command Line Tools 至 ~/Library/Android/sdk/cmdline-tools/latest/,并确保 adb、sdkmanager 在 PATH 中。
2、在终端中运行 sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0" 安装必要组件。
3、安装 Android Debug Bridge 插件(由 mattia72 提供),重启 VSCode 后可在命令面板中使用 ADB: Start Server 和 ADB: Install APK。
四、调试 Kotlin JVM 与 Native 代码
VSCode 使用 CodeLLDB(针对 Native)和 Java Debugger(针对 JVM)分别处理不同目标的断点调试,需为每类目标单独配置 launch.json 启动项,且无法复用 Android Studio 的调试会话管理逻辑。
1、点击左侧活动栏的调试图标,选择 create a launch.json file,然后选择 CodeLLDB 或 Java 环境。
2、对 JVM 目标,在 configurations 数组中添加字段:"mainClass": "com.example.HelloKt",并确认 classpath 包含 build/classes/kotlin/jvm/。
3、对 Native 目标(如 iosX64),确保已通过 ./gradlew linkDebugExecutableIosX64 生成 .kexe 文件,并在 launch.json 中设置 "program": "./build/bin/iosX64/debugExecutable/MyApp.kexe"。
五、替代方案:使用 JetBrains Projector 远程连接 IntelliJ IDEA
当 VSCode 配置复杂度超出维护阈值时,可借助 Projector 将远程 IntelliJ IDEA 实例以网页形式投射至 VSCode 内置浏览器,复用其完整 Kotlin 支持,同时保留 VSCode 快捷键与快捷操作习惯。
1、在服务器端执行 git clone https://github.com/JetBrains/projector-server 并构建最新版本。
2、启动 IDEA 时附加参数:-Dprojector.server.port=8887 -Dprojector.headless.mode=true。
3、在 VSCode 中新建空白标签页,访问 http://localhost:8887,即可加载远程 IDEA 界面。










