必须先安装JDK 17/21并配置JAVA_HOME,再通过SDKMAN!安装Kotlin(推荐)或手动部署ARM64兼容的kotlinc编译器,最后验证kotlin -version及IDEA中启用Kotlin插件并绑定工具链。

Linux下安装Kotlin开发环境,核心是装好 kotlin 命令行编译器 + JDK,两者缺一不可。只装Kotlin不配JDK,kotlin -version 会直接报错 Command 'kotlin' not found 或 No Java runtime present;只装JDK不装Kotlin,则无法编译 .kt 文件。
必须先确认JDK已安装且可用
Kotlin运行依赖JVM,不是“可选”,而是硬性前提。执行以下命令验证:
-
java -version—— 必须输出类似openjdk version "17.0.2"的有效版本(推荐JDK 17或21,JDK 8已过时) -
which java—— 确保路径非空,且指向真实JDK安装目录(如/usr/lib/jvm/java-17-openjdk-amd64/bin/java) - 若未安装,Ubuntu/Debian用
sudo apt install openjdk-17-jdk;CentOS/RHEL用sudo dnf install java-17-openjdk-devel
推荐用SDKMAN!安装Kotlin(macOS/Linux通用)
SDKMAN! 是目前最稳定、易切换版本的方案,比手动下载解压更可靠,也比包管理器(如apt)更新及时。步骤极简:
- 执行
curl -s "https://get.sdkman.io" | bash安装SDKMAN! - 运行
source "$HOME/.sdkman/bin/sdkman-init.sh"加载环境(也可新开终端) - 执行
sdk install kotlin—— 默认装最新稳定版(当前为1.9.24) - 验证:
kotlin -version应输出版本号和JRE信息,例如Kotlin version 1.9.24 (JRE 17.0.2+8)
注意:sdk list kotlin 可查看所有可用版本;sdk use kotlin 1.9.20 能临时切换,适合多项目协作。
手动安装仅在受限环境才考虑
比如无外网、不能装SDKMAN!、或需固定某旧版Kotlin时才用。流程繁琐且容易出错:
- 去
https://github.com/JetBrains/kotlin/releases下载kotlin-compiler-*.zip(别下错成Source Code) - 解压后得到
kotlinc目录,设环境变量:export KOTLIN_HOME=/path/to/kotlinc,并把$KOTLIN_HOME/bin加进PATH - 手动方式没版本管理能力,升级要重下、重配、重改PATH,
kotlinc命令名也和SDKMAN!的kotlin不一致,容易混淆
IntelliJ IDEA里Kotlin插件通常不用额外装
2020.3及以后版本的IDEA Community/Ultimate,Kotlin插件默认内置。启动IDEA后:
- 新建项目时选择
Kotlin模板,IDEA会自动配置Gradle或Maven依赖 - 若旧版IDEA(如2018.x),需手动进
Settings → Plugins → Marketplace搜索Kotlin并安装 - 注意:插件 ≠ 编译器 —— 即使插件装了,命令行仍需独立安装
kotlin,否则kotlinc命令不可用,CI/脚本会失败
真正容易被忽略的是:JDK版本和Kotlin版本的兼容性。比如Kotlin 1.9要求JDK 17+,但某些老项目用了Kotlin 1.6,强行用JDK 21会导致编译失败,报错类似 Unsupported class file major version 64 —— 这时候就得用 sdk use java 17.0.2-open 切换JDK,再 sdk use kotlin 1.6.21 配套切换。版本对齐才是实际开发中最常卡住的地方。


















