Sublime如何配置Kotlin开发环境 Sublime编写Kotlin脚本【实战】
开门见山地说，Sublime Text 本身并不能直接运行 Kotlin 代码，它需要依赖外部的 kotlinc 和 kotlin 命令来驱动。 所以，所谓的“配置环境”，本质上就是打通 Sublime 调用这两个命令的路径——而这一切的前提，是它们在你的系统终端里已经能直接运行了。
验证 kotlinc 和 kotlin 是否就绪
这是所有后续步骤的基石，必须首先确认。Sublime 的构建系统（Build System）通常不会友好地提示“命令未安装”，它要么静默失败，要么弹出一个令人困惑的 'kotlinc' is not recognized。
- 打开你的系统终端（macOS/Linux 用 Terminal，Windows 用户请注意：请使用 CMD，而不是 PowerShell），分别执行：
kotlinc -version和kotlin -version。两者都必须正常输出版本号（例如Kotlin Compiler 1.9.24）。 - 这里有个常见的坑：如果你只安装了 Android Studio，或者通过
brew install kotlin这样的方式安装，很可能只有运行时（kotlin命令可用），而缺少编译器（kotlinc会报错）。这时，你需要去 Kotlin 官网下载官方的 CLI 压缩包（kotlin-*.zip），解压后将其bin/目录添加到系统的 PATH 环境变量中。 - 对于 Windows 用户，修改完 PATH 后，务必重启一次 Sublime Text。因为 Sublime 在启动时会读取一次环境变量，不重启它永远也找不到新添加的
kotlinc.bat。
安装 LanguageKotlin 插件启用语法高亮
先排个雷：不要去安装那些名字里带 “JetBrains” 或 “SublimeKotlin” 的老旧插件，它们已经多年没有维护，对 Kotlin 1.8+ 版本引入的 val 解构、sealed interface 等新语法支持很差，会显示错误的高亮。
- 通过 Sublime 的命令面板（
Ctrl+Shift+P/Cmd+Shift+P）运行Package Control: Install Package。 - 搜索并安装
LanguageKotlin插件（这个插件的作者是 JetBrains，源码在其jetbrains/intellij-community仓库下）。 - 新建一个文件并保存为
hello.kt，此时编辑器右下角的状态栏应该会自动显示为Kotlin。如果没有，可以手动点击那里的语言名称，然后选择Open all with current extension as → Kotlin。 - 注意一个细节：
.kts文件（Kotlin 脚本）默认可能不会被识别为 Kotlin 语言。你需要单独设置一下：打开任意一个build.gradle.kts文件，点击右下角语言名，同样选择Open all with current extension as → Kotlin即可。
编写一个真正可用的 Kotlin.sublime-build
网上能找到的很多配置 JSON，喜欢把编译和运行命令硬塞进同一个 cmd 数组里，用 && 连接。这种做法在 Windows 系统上尤其脆弱，很容易因为路径空格、引号问题或 shell 类型而导致失败。更稳健的做法是利用 variants 字段拆分成多个变体，并且明确指定 shell: true。
- 在 Sublime 菜单栏选择
Tools → Build System → New Build System…。 - 将以下内容粘贴进去（macOS/Linux 用户可以直接用
kotlinc；Windows 用户如果安装路径包含空格，则必须使用完整路径，例如C:\kotlin\bin\kotlinc.bat）：
{
"cmd": ["kotlinc", "$file", "-include-runtime", "-d", "${file_base_name}.jar"],
"file_regex": "^([^ ]+)\s+([0-9]+):([0-9]+):\s+(.*)$",
"selector": "source.kotlin",
"shell": true,
"working_dir": "$file_path",
"variants": [
{
"name": "Run",
"cmd": ["kotlin", "${file_base_name}.jar"]
}
]
}
- 将其保存为
Kotlin.sublime-build（注意扩展名是.sublime-build，不是.json）。 - 这里有个关键点：编译命令中的
-include-runtime参数必须加上，否则生成的.jar文件不包含 Kotlin 运行时库，后续用kotlin xxx.jar运行时会抛出ClassNotFoundException: kotlin.jvm.internal.Intrinsics这类错误。 - 另外，确保你的 Kotlin 文件里，
main函数是顶层函数（不要写在 class 内部）。对于 Kotlin 1.7+ 版本，推荐使用fun main() { ... }这种简洁形式，除非你真的需要命令行参数，否则不必写成fun main(args: Array。) { ... }
为运行 .kts 脚本配置快捷方式
如果你主要编写的是 Kotlin 脚本文件（比如用于构建部署的 deploy.kts），其实不需要编译成 jar 包，直接用 kotlin 命令解释执行会更加轻便快捷。
- 我们再新建一个构建系统：
Tools → Build System → New Build System…。 - 内容如下（这个配置专门针对
.kts文件）：
{
"cmd": ["kotlin", "$file"],
"selector": "source.kotlin",
"shell": true,
"file_regex": "^([^ ]+)\s+([0-9]+):([0-9]+):\s+(.*)$"
}
- 将其保存为
KotlinScript.sublime-build。 - 使用前，请确保文件后缀名是
.kts，并且编辑器右下角已正确识别为Kotlin语言（否则selector选择器无法匹配）。 - 这种方式跳过了编译步骤，因此无法进行调试，也没有严格的类型检查，但它胜在快速，非常适合用来验证一些逻辑或者编写胶水脚本。
最后，分享一个最容易被忽略的细节：Sublime 构建系统里使用的路径变量（比如 $file），在 Windows 平台上会包含反斜杠 \，而 kotlinc 在内部处理时可能会因此出错。如果你遇到了 error: invalid path 这类报错，可以尝试将 $file 替换为 "$file_path/$file_name" 的显式组合形式，同时确保文件路径中不包含中文或空格，问题通常就能解决。
