Sublime如何配置Kotlin开发环境 Sublime编写Kotlin脚本【实战】

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" 的显式组合形式，同时确保文件路径中不包含中文或空格，问题通常就能解决。