需安装JetBrains官方Kotlin扩展并配置Language Server路径,同时手动关联.kt/.kts文件类型为Kotlin语言模式,才能启用语法高亮、代码补全及错误检查功能。

如果您在 Visual Studio Code 中编辑 Kotlin 代码,但无法获得语法高亮、代码补全或错误检查等功能,则可能是由于缺少正确的语言支持扩展或配置未生效。以下是为 VSCode 添加并启用 Kotlin 语言支持的具体操作步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装官方 Kotlin 扩展
Kotlin 官方推荐的 VSCode 扩展由 JetBrains 维护,提供基础语法支持、代码高亮与简单导航功能。该扩展不依赖 JDK 或构建工具,适合快速查看 Kotlin 文件。
1、打开 VSCode,点击左侧活动栏的扩展图标(或按快捷键 Ctrl+Shift+X)。
2、在搜索框中输入 Kotlin Language。
3、在结果中找到名称为 Kotlin Language、发布者为 JetBrains 的扩展。
4、点击“安装”按钮,等待安装完成。
5、安装完成后,重启 VSCode 或重新打开一个 .kt 文件以触发语言模式识别。
二、配置 Kotlin 插件与 Kotlin Language Server
若需完整语言功能(如跳转定义、实时错误诊断、重构提示),需配合 Kotlin Language Server 使用。该服务通过 LSP 协议与 VSCode 通信,要求本地已安装 Kotlin 编译器工具链。
1、访问 https://github.com/fwcd/kotlin-language-server/releases,下载最新版预编译二进制包(如 kotlin-language-server-standalone-0.16.0.zip)。
2、解压后将可执行文件(如 kotlin-language-server)放入系统 PATH 目录,或记录其绝对路径。
3、在 VSCode 中按下 Cmd+, 打开设置,搜索 kotlin.languageServerPath。
4、点击“在 settings.json 中编辑”,添加如下行(路径请替换为实际路径):
"kotlin.languageServerPath": "/usr/local/bin/kotlin-language-server"。
5、确保当前工作区根目录下存在 build.gradle.kts 或 gradle.properties 文件,以便插件自动识别项目结构。
三、启用 Kotlin 文件关联与默认语言模式
VSCode 默认可能未将 .kt 和 .kts 文件识别为 Kotlin 类型,需手动绑定文件扩展名与语言模式,否则语法高亮和智能提示不会激活。
1、在任意 Kotlin 源文件(如 Main.kt)中右下角状态栏点击当前语言标识(例如 “Plain Text”)。
2、在弹出菜单中选择 Configure File Association for '.kt'。
3、在后续选项中选择 Kotlin。
4、重复上述步骤,为 .kts(Kotlin 脚本)文件类型也设置相同关联。
5、打开命令面板(Cmd+Shift+P),输入 Developer: Inspect Editor Tokens and Scopes,确认当前编辑器的语言模式显示为 kotlin。










