vscode配置kotlin环境需手动对齐jdk、kotlinc、gradle路径并用绝对路径配置；语法高亮依赖java扩展的runtimes设置且必须重启生效；单文件运行需code runner自定义含-include-runtime的命令；gradle项目须声明kotlin("jvm")和jvmtoolchain；调试推荐codelldb+gradlew run。
装完 Kotlin 插件 ≠ 能高亮、能运行、能调试——必须手动对齐 JDK、kotlinc、Gradle 三者路径，且每处配置都要求绝对路径 + 重启生效。
为什么 .kt 文件没语法高亮
只装 fwcd.kotlin 插件就能启用基础高亮，但它不依赖 JDK；若仍无高亮，大概率是文件语言模式没设对或插件未注入到已打开的编辑器中：
- 右下角点击当前语言（如 “Plain Text”），手动选成
Kotlin - 关掉所有
.kt文件，再重新打开 - 确认没误装已归档的
Kotlin Language Server（GitHub 标记为 Deprecated）
如果连括号匹配、代码折叠都失效，检查是否装了名字含 “IntelliJ” 或 “JetBrains” 的插件——它们在 VSCode 中完全无效，还会冲突。
怎么让 kotlinc 命令在 VSCode 里被识别
kotlin.compilerPath 必须显式指向可执行文件，不能靠 PATH 或环境变量自动发现：
- 终端运行
kotlinc -version确认命令可用 - VSCode 设置中搜索
kotlin.compilerPath，填入绝对路径，例如：/opt/homebrew/bin/kotlinc（macOS Homebrew）D:\kotlinc\bin\kotlinc.bat（Windows 手动解压） - 路径中不能用
~或$JAVA_HOME，否则插件报kotlinc not found
该配置只影响插件内联诊断（如编译错误提示），不影响 Code Runner 运行逻辑。
Code Runner 怎么跑通单文件 .kt
默认配置会漏掉 -include-runtime，导致 NoClassDefFoundError: kotlin/jvm/internal/Intrinsics：
- 在
settings.json中覆盖执行命令："code-runner.executorMap": { "kotlin": "cd $dir && kotlinc -include-runtime -d out.jar $fileName && java -jar out.jar" } -
fun main()必须是顶层函数，不能在 class 内；签名支持无参或args: Array<string></string> - 含
package com.example或任何依赖（如kotlinx.coroutines）的文件，此方式直接失败——它不读build.gradle.kts
想跑脚本式代码（.kts），改用 kotlinc -script $fileName，但同样不支持第三方依赖。
Gradle 项目报 “No SDK configured” 或无法跳转
VSCode 不解析任意位置的 Gradle 配置，只认标准结构 + 显式声明：
- 项目根目录必须有
settings.gradle.kts（哪怕内容为空） -
build.gradle.kts至少含这两段：plugins { kotlin("jvm") version "1.9.24" }kotlin { jvmToolchain(17) } - 源码必须放在
src/main/kotlin下；放错路径（如直接丢根目录）会导致插件完全无视 -
java.home和java.configuration.runtimes也得配对 JDK 17+ 绝对路径，否则类型跳转、补全全部失效
最易忽略的是：VSCode 启动时加载 JDK 映射，改了 java.configuration.runtimes 不重启等于白配。
