vscode运行kotlin需依赖外部工具链驱动，非装插件即可运行；单文件用code runner配kotlinc命令并加-include-runtime，gradle项目须配置kotlin("jvm")、jvmtoolchain(17)及mainclass.set("xxxkt")，调试推荐launch.json设type为java并匹配kt后缀类名或通过./gradlew run --no-daemon启动。
VSCode 能跑 Kotlin，但不是“装插件点一下就成”——它不编译、不管理依赖、不自动找 main，所有运行动作都靠你配对的外部命令或 Gradle 任务驱动。错配环境或路径，NoClassDefFoundError、UnsupportedClassVersionError、Could not find or load main class 就会立刻报给你看。
Code Runner 运行单个 .kt 文件为什么总失败
Code Runner 本质是把你的 .kt 文件丢给 kotlinc 编译再执行 jar，它不读 build.gradle.kts，也不下载任何依赖。
-
fun main()必须是顶层函数（不能在 class 里），否则编译后找不到入口类 —— 类名是FileNameKt，不是FileName - 如果用了
kotlinx.coroutines或其他第三方库，直接报unresolved reference：Code Runner 不解析依赖，只认标准库 -
kotlinc -include-runtime必须加，否则生成的 jar 缺少 kotlin-stdlib，java -jar会炸 - 终端乱码？在
settings.json加"code-runner.runInTerminal": true，让输出走系统终端而非集成终端
Gradle 项目里 ./gradlew run 报 Could not find or load main class
这不是 VSCode 的问题，是 Gradle 配置没对齐 Kotlin 的 JVM 类命名规则。
-
mainClass.set("com.example.AppKt")—— 注意末尾的Kt，不是App，也不是App.kt；Kotlin 编译器把顶层main()打包进AppKt.class -
jvmToolchain(17)不能省：不写就用 Gradle 自带 JDK（常为 JDK 11），和 Kotlin 1.9+ 编译字节码版本不匹配，触发UnsupportedClassVersionError - 项目根目录必须有可执行的
gradlew，且build.gradle.kts中kotlin("jvm")插件已声明，否则 VSCode 的 Gradle Tasks 插件压根识别不了任务
launch.json 调试 Kotlin 时断点不生效
VSCode 的 Kotlin 调试不是解释执行，而是 attach 到 JVM 进程。照搬 Java 配置或手填类名，90% 情况下断点白挂。
- 别用
type: "shell"直接调kotlinc编译 —— 生成的 class 文件路径和源码映射关系错乱，debugger 找不到对应行 - 正确做法：在
launch.json中设"type": "java"，"mainClass": "com.example.MainKt"（再次强调Kt后缀） - 更稳的方式是用 Gradle 启动调试模式：
./gradlew run --no-daemon -Dorg.gradle.debug=true，然后在launch.json里选Attach to Remote JVM，端口默认 5005 - 如果项目含多模块或
android块，mainClass很可能带$符号（如MainActivityKt$onCreate$0），手动填几乎必错 —— 此时只能走 Gradle attach
最易被忽略的点：VSCode 从不“理解” Kotlin，它只转发命令、渲染日志、跳转符号。所有可靠性来自你本地的 kotlinc 版本、JDK 版本、Gradle 配置三者是否对齐 —— 差一个点，main 就找不到，debug 就挂不上，连 println 都可能乱码。
