根本原因是VSCode Java扩展未识别Kotlin编译输出路径，因其默认只扫描.java文件和target/classes，而Kotlin字节码位于build/classes/kotlin/main等非默认路径，导致跳转、重命名等功能失灵；需在.settings.json中正确配置java.project.outputPath指向实际Kotlin输出目录。
为什么 Kotlin/Java 混编时 Ctrl+Click 跳转经常失效
根本原因不是插件没装，而是 Java 扩展链路未识别 Kotlin 生成的 class 文件或 stubs。VSCode 的 Java Extension Pack 默认只扫描 .java 和 target/classes，但 Kotlin 编译输出（如 build/classes/kotlin/main）不在默认路径里，导致跳转、重命名、引用查找全部失灵。
解决方法是在项目根目录的 .vscode/settings.json 中显式声明 Kotlin 输出路径：
{
"java.configuration.updateBuildConfiguration": "interactive",
"java.project.sourcePaths": ["src/main/java", "src/main/kotlin"],
"java.project.outputPath": "build/classes"
}
注意：outputPath 必须指向 Gradle 实际输出目录（Kotlin JVM 项目通常是 build/classes/kotlin/main），不能写成 build/classes 就完事——否则 Java 扩展会忽略 Kotlin 字节码。
快速切换 Java ↔ Kotlin 文件的快捷键怎么配
混编项目里，UserService.java 和 UserService.kt 常成对存在。手动在侧边栏点来点去效率低，且容易开错标签页。
立即学习“Java免费学习笔记（深入）”；
推荐在 keybindings.json 中加一条规则，用 Ctrl+Alt+K（Windows/Linux）或 Cmd+Alt+K（macOS）一键切换：
[{
"key": "ctrl+alt+k",
"command": "workbench.action.quickOpen",
"args": "-f UserService.*\.(java|kt)$",
"when": "editorTextFocus"
}]
说明：
-
-f表示按文件名过滤，正则匹配当前编辑器打开文件的 base name（不含扩展名） - 实际使用时，光标聚焦在
UserService.java上，按Ctrl+Alt+K就弹出UserService.kt；反之亦然 - 如果项目中同名文件不止一对（比如还有
UserServiceTest.java），建议改用更精确的正则，例如-f UserService\.(java|kt)$
Code Runner 运行 Kotlin 文件时总报 NoClassDefFoundError
错误信息是 NoClassDefFoundError: kotlin/jvm/internal/Intrinsics，本质是 kotlinc 编译时没打包 Kotlin 运行时库。
必须在 settings.json 的 code-runner.executorMap 里强制加 -include-runtime 参数：
"code-runner.executorMap": {
"kotlin": "cd $dir && kotlinc -include-runtime -d out.jar $fileName && java -jar out.jar"
}
关键点：
- 漏掉
-include-runtime→ 生成的out.jar不含kotlin-stdlib，运行时报错 - 不能用
kotlinc -script替代：它只适用于.kts脚本，对.kt主类无效 - 如果项目用了
kotlinx.coroutines等第三方依赖，Code Runner仍会失败——它不读build.gradle.kts，这种场景必须走 Gradle 任务
Gradle 任务列表里 Kotlin 编译任务不显示
即使装了 Gradle for Java 插件，VSCode 侧边栏的 GRADLE TASKS 里也看不到 compileKotlin 或 run，是因为插件没触发 Gradle 项目初始化。
手动触发方式只有两种：
- 在命令面板（
Ctrl+Shift+P）执行Java: Configure Classpath，选当前项目 → VSCode 会扫描build.gradle.kts并加载 Kotlin 插件任务 - 或者删掉项目根目录下的
.vscode文件夹和.gradle目录，重新用File → Open Folder打开项目，让 Java 扩展从头识别
注意：gradle wrapper 必须可用，且 build.gradle.kts 中已启用 kotlin("jvm") 插件——否则 Gradle 本身就不认识 Kotlin 任务，VSCode 更无从发现。
最常被忽略的是：Kotlin JVM 项目必须有 src/main/kotlin 目录，且至少有一个 .kt 文件，否则 Gradle 插件不会激活编译任务。
