Sublime Text 本身并不具备运行 Kotlin 代码的能力。它更像一个“调度员”，负责调用你系统里已经装好的 kotlinc 和 ja va 命令。

所以，所有配置的前提只有一个：确保在终端里敲 kotlinc -version 和 ja va -version 能正常返回信息，并且 JDK 版本不低于 17。

这一步如果没搞定，后面无论怎么折腾都是白费功夫。

先确认基础环境可用

验证 kotlinc 和 ja va 是否真可用

这是最容易被跳过的一步，也是 90% 编译失败的根源。

Sublime 的构建系统通常不会明确提示“命令未找到”。它更可能静默失败，或者只弹出一个“file not found”，让人很难定位问题。

因此，请务必先在终端里手动确认：

• 打开终端，注意不是 Sublime 内置的 console，执行 kotlinc -version。如果看到类似 Kotlin Compiler 1.9.24 的输出，说明第一步通了。
• 接着执行 ja va -version，JDK 版本建议 ≥17（Kotlin 1.9+ 要求 JVM 17+ 才能运行）。
• 检查 PATH 环境变量是否包含了 kotlinc 所在目录：macOS/Linux 上主要看 ~/.zshrc 或 ~/.bash_profile 里有没有 export PATH="/path/to/kotlin/bin:$PATH"；Windows 用户直接去系统环境变量里检查 Path 即可。
• 顺便提一嘴：别用 brew install kotlin 来安装——它通常只装了 runtime，缺少 kotlinc 编译器，执行 kotlinc -version 会直接报 command not found。

语法插件要装对

安装正确的 Kotlin 语法插件（不是 JetBrains 官方版）

Sublime 不靠插件来“运行”Kotlin，但语法高亮全靠它。

如果插件装错了，可能会导致 .kt 文件识别失败、括号不匹配，甚至影响构建系统触发。

这里有几个关键点：

• 通过 Package Control 安装时，搜索 “Kotlin”，选择作者为 sublack 或 fwcd 的包（这两个在 GitHub 上活跃维护）。避开名字里带 “JetBrains” 或 “SublimeKotlin” 的旧包，它们已经过时了。
• 安装后重启 Sublime，新建一个 test.kt 文件。如果右下角状态栏显示的语法不是 Kotlin，就点击语法名 → Open all with current extension as… → Kotlin，强制将 .kt 后缀与 Kotlin 语法关联起来。
• 如果之前装过其他 Kotlin 插件（比如 SublimeKotlin），先卸载掉——它不提供语法定义，反而可能覆盖 source.kotlin 这个 selector，导致构建系统无法被正确触发。

构建系统配置是关键

配置 Kotlin.sublime-build 要注意 -include-runtime 和路径空格

Build System 是 Sublime 调用外部命令的唯一通道。

参数只要写错一点，就会出问题。最常见的坑，是编译成功但运行时报 NoClassDefFoundError: kotlin/jvm/internal/Intrinsics。

这通常是因为生成的 jar 里没有包含 Kotlin 标准库。

• "cmd" 中必须带 -include-runtime 参数，否则 ja va -jar 必然失败。
• 文件路径如果包含中文或空格，$file 会被拆成多个参数，导致命令出错。解决办法是在 cmd 里用引号包裹 $file，同时设置 "shell": true（macOS/Linux），或者在 Windows 上显式调用 cmd /c。
• selector 必须是 source.kotlin，不能写成 source.kt 或漏掉——这是 Sublime 识别“该用哪个构建系统”的唯一依据。
• 推荐将构建系统保存为 Packages/User/Kotlin.sublime-build，这样可以避免和插件自带的配置发生冲突。

.kts 脚本需要单独处理

运行 .kts 脚本要用单独的 KotlinScript.sublime-build

.kts 是 Kotlin 脚本格式，不能用 kotlinc 编译。

它要走 kotlin 命令直接解释执行，而且要求 JDK 和 Kotlin CLI 都支持脚本模式。

• 先验证终端里能不能跑：执行 kotlin hello.kts。如果报 command not found，说明 kotlin 命令没在 PATH 里（它和 kotlinc 在同一个目录，但某些 SDKMAN! 安装方式默认不会创建软链接）。
• 新建一个 Build System，内容如下：

  { "cmd": ["kotlin", "$file"], "selector": "source.kotlin", "file_regex": "^([^ ]+)s+([0-9]+):([0-9]+):s+(.*)$", "shell": true }

• 保存为 KotlinScript.sublime-build，然后对 .kts 文件按 Ctrl+Shift+B（Windows/Linux）或 Cmd+Shift+B（macOS），选择这个构建系统来运行。
• 注意：.kts 文件里不能有 package 声明，main 逻辑必须以顶层表达式形式存在，否则 kotlin 命令会拒绝执行。

最后再检查一次常见卡点

真正卡住人的，从来不是 Sublime 本身的配置。

核心问题通常只有这几个：

• kotlinc 和 ja va 在终端里能不能跑通
• 路径里有没有空格
• JDK 版本跟不跟得上 Kotlin 编译器

配完之后，记得关掉所有 Sublime 窗口再重新打开。

有些插件的加载和语法 selector 的绑定，只在启动时才会生效。