只装 kotlin language（fwcd 开发）插件即可实现 kotlin 代码高亮，它提供语法高亮、括号匹配和基础代码折叠，不依赖 jdk 或构建工具，开箱即用；其他 intellij 相关插件在 vscode 中无效且可能冲突。
VSCode 装什么插件才能高亮 Kotlin 代码
只装 Kotlin Language（由 fwcd 开发）这一个插件就够了。它提供语法高亮、括号匹配、基础代码折叠，不依赖 JDK 或构建工具，开箱即用。
别装 intellij-idea-kotlin 或其他名字带 “IntelliJ”“JetBrains” 的插件——它们是给 IntelliJ 平台用的，在 VSCode 里压根不生效，还可能冲突。
- 插件 ID 是
fwcd.kotlin，VSCode 扩展市场搜这个名字最准 - 如果装完没反应，关掉所有
.kt文件再重开，插件不会自动注入到已打开的编辑器中 - 确认文件关联：右下角点击语言模式（显示 “Plain Text” 或 “Kotlin”），手动选成
Kotlin；否则即使装了插件也不高亮
怎么在 VSCode 里直接运行单个 Kotlin 文件（不用 Gradle）
靠 kotlinc-jvm 编译 + java 运行，本质是命令行调用，VSCode 只做封装。前提是本地已装好 JDK（11+）和 Kotlin CLI（kotlinc 命令可用）。
别指望点一下就跑起来——VSCode 默认不绑定任何执行逻辑，必须手动配 tasks.json 或用插件补能力。
- 推荐用
Code Runner插件（junhan.chen 开发），装完后在设置里加一行："kotlin": "kotlinc-jvm $fileName -include-runtime -d $fileNameWithoutExt.jar && java -jar $fileNameWithoutExt.jar" - 如果报错
Could not find or load main class，大概率是没写fun main()，或函数签名不对（必须是fun main(args: Array<string>)</string>或无参main()） -
kotlinc-jvm编译出的 jar 默认不含标准库，加-include-runtime才能脱离环境运行
为什么按 F5 调试 Kotlin 总失败
VSCode 官方 Debugger for Kotlin 插件（by mathiasfrohlich）**仅支持基于 Gradle/Maven 的项目调试**，对单文件、无构建配置的场景完全无效。这是设计限制，不是配置问题。
想真断点调试，只有两条路：建一个最小 Gradle 项目，或改用 IntelliJ IDEA。别在 VSCode 里硬扛调试需求。
- 常见错误现象：
launch: program 'xxx.kt' does not exist或直接弹窗说 “No debug adapter installed” - 就算你手写
launch.json，指定type: "kotlin"，没有后台调试服务（debug adapter）也起不来 - 有人试过用
java类型调试编译后的 jar，但无法映射源码、看不到val变量值，实用性极低
Mac / Linux 下路径或权限相关坑
kotlinc-jvm 在非 Windows 系统上对空格、中文路径特别敏感，且默认不加执行权限，容易卡在 “command not found” 或 “Permission denied”。
不是 VSCode 的锅，是 Kotlin CLI 工具链本身的限制，得从系统层面对齐。
- 检查
kotlinc-jvm是否可执行：which kotlinc-jvm；如果返回空，说明没加到$PATH，或安装不完整 - Mac 上通过 Homebrew 安装后，路径通常是
/opt/homebrew/bin/kotlinc-jvm，确保该目录在 shell 的PATH里（.zshrc 中追加export PATH="/opt/homebrew/bin:$PATH"） - Linux 下若用 tar.gz 手动解压安装，进
bin/目录执行chmod +x *.sh，否则kotlinc-jvm脚本根本跑不起来
