VS Code 运行 Kotlin 需装 kotlinc、Gradle 和插件协同：1. 安装 kotlinc 并配置 PATH；2. 装 Red Hat Kotlin 插件（语法支持）+ Gradle（构建）或 Code Runner（脚本式）；3. 调试需额外装 fwcd.kotlin 插件并确保 build 生成 jar。
VS Code 本身不原生支持 Kotlin 编译与运行，必须借助插件和外部工具链协同工作；直接装个插件点“运行”就出结果，是不可能的。
安装 Kotlin 编译器（kotlinc）并配置 PATH
Kotlin 官方命令行编译器是基础依赖，VS Code 插件无法绕过它。不装 kotlinc，连最简单的 HelloWorld.kt 都编译不过。
- 推荐通过
sdkman安装（Linux/macOS）：sdk install kotlin，自动配置好PATH - Windows 用户建议用
choco install kotlin，或手动下载 Kotlin release zip，解压后把bin/目录加进系统PATH - 验证是否生效：终端执行
kotlinc -version，应输出类似Kotlin version 2.0.0 - 常见坑：VS Code 终端能运行
kotlinc，但图形界面右键“Run Code”失败——大概率是 VS Code 没读取到你 shell 中的PATH，重启 VS Code 或改用集成终端启动
安装 Kotlin 插件与配套构建工具
仅装 Red Hat's Kotlin 插件（ID: redhat-developer.vscode-kotlin）只提供语法高亮和简单补全，不带运行能力。必须搭配构建工具才能真正编译、依赖管理、运行。
- 日常开发强烈建议用
Gradle：新建项目时用gradle init --type kotlin-application，插件会自动识别build.gradle.kts - 如果坚持纯脚本式开发（无构建文件），可用
Code Runner插件（ID:formulahendry.code-runner），但需手动配置其code-runner.executorMap：
"code-runner.executorMap": {
"kotlin": "cd $dir && kotlinc $fileName -include-runtime -d $fileNameWithoutExt.jar && java -jar $fileNameWithoutExt.jar"
}
- 注意：
-include-runtime是关键，否则运行时报NoClassDefFoundError: kotlin/jvm/internal/Intrinsics - 不推荐用
Maven起步——Kotlin 的 Maven 插件配置比 Gradle 更冗长，出错概率更高
调试 Kotlin 代码需要额外装 Debugger for Kotlin
Red Hat 插件不提供调试功能。想设断点、看变量、单步执行，必须装另一个插件。
- 安装
fwcd.kotlin（ID:fwcd.kotlin），它基于Debug Adapter Protocol，支持 Launch/Attach 模式 - 要求项目有
build.gradle.kts且已生成.class或.jar输出，否则调试器找不到可执行字节码 - 调试前务必先执行一次
./gradlew build，否则launch.json中的program路径（如build/libs/xxx.jar）会不存在 - 常见错误信息：
Cannot find the main class—— 检查build.gradle.kts是否正确设置了application.mainClass.set("MainKt")
真正卡住人的往往不是“怎么配”，而是路径没对齐、插件职责混淆、或者误以为 Kotlin 像 Python 那样“保存即运行”。每一步都要验证中间产物：有没有生成 .jar？java -jar 能否手动跑通？VS Code 终端的 PATH 和你平时用的终端是否一致？这些细节比插件列表重要得多。
