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>) { ... }（除非你真需要参数）
运行 .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" 并确保路径不含中文或空格。
