sublime text 需通过外部 kotlinc 和 kotlin 命令运行 kotlin,先验证二者版本可用;安装 languagekotlin 插件启用语法高亮;配置 kotlin.sublime-build 实现编译+运行,kotlinscript.sublime-build 直接解释执行 .kts 文件。

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,大概率只有 runtime(kotlin可用),缺编译器(kotlinc报错)。必须单独下载官方 CLI 包(kotlin-*.zip),解压后把bin/加入 PATH - Windows 用户改完 PATH 后,务必重启 Sublime —— 它启动时读的是旧环境变量,不重启就永远找不到
kotlinc.bat
用 LanguageKotlin 插件启用语法高亮
别装名字带 “JetBrains” 或 “SublimeKotlin” 的老插件,它们已多年未维护,对 Kotlin 1.8+ 的 val 解构、sealed interface 等新语法识别错误。
- 通过 Command Palette(
Ctrl+Shift+P/Cmd+Shift+P)运行Package Control: Install Package - 搜索并安装
LanguageKotlin(作者是JetBrains,GitHub 仓库为jetbrains/intellij-community下的子模块) - 新建文件保存为
hello.kt,右下角状态栏应自动显示Kotlin;若没触发,手动点它 →Open all with current extension as → Kotlin - 注意:
.kts文件(Kotlin Script)默认不被识别为 Kotlin,需单独设置:打开任意build.gradle.kts→ 点右下角语言名 →Open all with current extension as → Kotlin
写一个真正可用的 Kotlin.sublime-build
网上流传的 JSON 常把编译和运行塞进同一个 cmd 数组,用 && 连接,这在 Windows 上极易因空格、引号或 shell 类型失效。正确做法是拆成 variants,且明确指定 shell: true。
- 菜单 →
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(注意扩展名,不是 .json) - 关键点:
-include-runtime必须加,否则kotlin xxx.jar会报ClassNotFoundException: kotlin.jvm.internal.Intrinsics -
main函数必须是顶层函数(不能在 class 内),且签名要匹配 Kotlin 版本:1.7+ 推荐用fun main() { ... },别写fun main(args: Array<string>) { ... }</string>(除非你真需要参数)
运行 .kts 脚本的快捷方式
如果你主要写 Kotlin 脚本(比如 deploy.kts),不用编译 jar,直接用 kotlin 命令解释执行更轻量。
- 另建一个 Build System:
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不匹配) - 这个方式跳过编译,但无法调试、无类型检查,适合快速验证逻辑或胶水脚本
最容易被忽略的一点:所有构建系统里的路径变量(如 $file)在 Windows 上会带反斜杠 ,而 kotlinc 内部处理时可能出错;如果遇到 error: invalid path,把 $file 换成 "$file_path/$file_name" 并确保路径不含中文或空格。











