Sublime Text中Kotlin高亮需装jaredly插件、手动绑定.kt/.kts后缀、构建系统selector用source.kotlin且.kts用kotlin命令;Android DSL语法不着色属正常,因词法高亮不支持语义分析。

装错插件是90%白屏问题的根源
Sublime Text 默认完全不认识 .kt 和 .kts,所谓“装了没高亮”,八成是插件选错了。必须只装 jaredly 维护的 Kotlin 插件(GitHub 活跃更新),其他任何带 LanguageKotlin、SublimeKotlin、KotlinSupport 字样的包都要卸载——它们要么 selector 冲突,要么已停更三年以上。
安装方式只用 Package Control:Ctrl+Shift+P → 输入 Package Control: Install Package → 等列表加载完 → 输入 Kotlin → 选作者为 jaredly 的那个回车。安装后状态栏右下角会闪一下 Kotlin installed;不闪,说明根本没装上。
装完必须重启 Sublime,或手动执行 Ctrl+Shift+P → Set Syntax: Kotlin,否则新建文件仍 fallback 到 Plain text。
文件后缀绑定不手动做,.kt/.kts永远是白的
插件装对 ≠ 自动生效。Sublime 不靠文件内容识别语法,只认后缀 + 显式绑定。即使插件加载成功,MyActivity.kt 和 build.gradle.kts 仍可能显示为 Plain text。
必须分两步手动绑定:
- 打开任意
.kt文件 → 右下角点击当前语法名(如Plain text)→Open all with current extension as…→Kotlin - 再打开任意
.kts文件 → 同样操作 →Kotlin
这会在用户配置中写入映射规则,让所有同后缀文件默认走 Kotlin 词法分析器。如果跳过这步,安卓项目里扫 build.gradle.kts 能高亮但 MainActivity.kt 还是灰白——不是 bug,是没绑。
构建系统里 selector 必须小写且拼写准确
想用 Ctrl+B 编译运行 Kotlin,构建系统(.sublime-build)里的 selector 字段必须是 source.kotlin(全小写,无空格,无额外字符)。写成 source.Kotlin、source.Konlin 或 source/kotlin 都会失效,Sublime 直接忽略该构建项。
正确示例(适用于 .kt 文件):
{
"selector": "source.kotlin",
"cmd": ["kotlinc", "${file}", "-include-runtime", "-d", "${file_base_name}.jar"],
"variants": [
{
"name": "Run",
"cmd": ["java", "-jar", "${file_base_name}.jar"]
}
]
}
.kts 脚本需单独配构建系统,且必须用 kotlin 命令(不是 kotlinc):kotlin ${file}。Kotlin ≥1.9 已弃用 kotlinc -script,用错命令就报 Unknown argument。
Android 特有语法高亮不了?这正常
@Composable、by viewModels()、rememberSaveable 这类 Android Jetpack DSL 语法,在 Sublime 里不会被特殊着色——这不是插件问题,是词法高亮的天然限制。
Kotlin 插件只处理基础词法:关键字(fun、val)、字符串、注释、括号匹配等;annotation、delegate、DSL 函数属于语义层,需要 IDE 级别的解析支持(比如 Android Studio 的 Kotlin 编译器 backend)。Sublime 是文本编辑器,不是 IDE。
只要 fun 是蓝色、字符串是绿色、括号能配对、.kt 和 .kts 都有基础颜色区分,就说明配置成功。别拿它对标 Android Studio 的智能补全和语义高亮。


















