1. 为什么环境搭建是Kotlin入门的第一道坎1.1 Kotlin早就不是一门Android专有语言了很多人的印象还停留在Kotlin 是写 Android 用的但 2025 年的 Kotlin 生态早就超出了这个范畴。它运行在 JVM 上所以服务端开发、桌面工具、命令行脚本都能写Google 在 2017 年就把它扶正为 Android 官方一级开发语言现在新项目默认就是 Kotlin而 JetBrains 这几年押注的 Kotlin Multiplatform 更是把目标伸向 iOS、JS 和原生平台。这就带出一个关键判断你学 Kotlin 的最终目标决定了你该搭哪一套环境。如果目标是 Android老老实实装 Android Studio因为它自带 Kotlin 插件、Android SDK 和模拟器链路是完整的如果目标只是学会这门语言本身或者打算走服务端路线装 IntelliJ IDEA Community 版就够了轻量、免费、干净环境链路短不容易出幺蛾子。这篇文章的主线我放在 IDEA Community 上因为这个选择覆盖人群最广也是最不容易走弯路的一条路。1.2 多数入门者不是被语法难倒而是被环境卡住我带过不少新人发现一个挺反直觉的规律凡是说Kotlin 太难的人十个里有九个是栽在环境上而不是语法上。Kotlin 的语法在主流语言里算相当友好的变量声明、空安全、集合操作都直白到几乎没有理解门槛。真正劝退人的是这些问题JDK 装了但版本不对Kotlin 编译器报一堆看不懂的错环境变量没配好命令行认识 java 但 IDEA 不认或者网上教程版本太老JDK 8 时代的步骤拿到 JDK 17/21 上根本不适用。尤其是最后一个问题。很多老教程还在教你去 Oracle 官网下载 JDK、注册账号这已经跟不上现在的玩法了。社区现在的默认选择是 Eclipse Temurin、Azul Zulu 这些 OpenJDK 发行版免费且许可干净。所以环境搭建从来不只是装个软件它背后是一套选型逻辑。这套逻辑今天搞清楚了后面不管学协程、接触 Gradle、还是切到 Android Studio你都有一套自己的判断标准不会再被教程牵着鼻子走。2. 动手前的必修课JDK、JVM和Kotlin工具链到底是谁在干活2.1 一句话讲清楚JDK、JVM与Kotlin编译器的分工新手最常问的一个问题我学 Kotlin为什么要装 Java 的东西这个疑惑不解决后面每一步都会带着别扭。其实关系非常简单。JVMJava Virtual MachineJava虚拟机是一个运行环境负责执行字节码。Kotlin 代码编译之后生成的也是 JVM 字节码所以 Kotlin 天然依赖 JVM 才能跑起来。JDKJava Development Kit是一整套开发工具箱里面包含 JVM、编译器、调试工具和庞大的类库。没有 JDKKotlin 编译器和运行时都找不到灶台。Kotlin 编译器kotlinc负责把.kt源文件编译成.class字节码文件再把运行权交给 JVM。打个比方JDK 是一间完整的厨房JVM 是灶台kotlinc 是切菜师傅。你不可能跳过切菜师傅把生菜直接丢到灶台上就端出菜来。所以搭 Kotlin 环境的第一步永远是装 JDK而不是先装 IDEA 或 kotlinc。顺序一旦反了后面经常会卡在为什么 IDEA 里找不到 JDK这类问题上。2.2 JDK选型11、17还是21关于 JDK 版本我给新手的建议非常明确优先 JDK 17 或 JDK 21别再用 8 和 11除非公司项目有历史包袱。现在网上常见的问题恰恰是照着老教程装了 JDK 8然后发现 Kotlin 编译器报Unsupported class file major version之类的错根本原因就是 JDK 版本和工具链不匹配。JDK 版本维护状态推荐度说明JDK 8停止免费更新不推荐只存在于历史项目和大量旧教程中新项目完全没必要JDK 11维护晚期一般如果团队锁定了这个版本可以接受否则跳过JDK 17LTS维护良好推荐当前最稳妥的选择Kotlin、Gradle、IDEA 都支持得很完善JDK 21LTS当前主流推荐2025 年新项目无脑选这个性能和特性都有保障JDK 17 和 21 对 Kotlin 入门阶段的体感差异几乎为零所以你不必纠结太多。只要避开 JDK 8机器上装 21 就是最省心的选择。2.3 IDE与命令行四种可行方案的取舍Kotlin 官方推荐的 IDE 是 IntelliJ IDEA但现实里方案不止一种。我列个表方便你根据自己的实际情况做决定。方案适用场景优点缺点IntelliJ IDEA Community通用学习、服务端、桌面开发免费、Kotlin 支持开箱即用、补全和调试体验极佳不支持 Android 开发Android StudioAndroid 方向官方 Kotlin 支持完整模拟器、真机调试链路齐全体积很大纯学 Kotlin 略显笨重kotlinc 编辑器命令行玩家极轻量能真正理解编译链条没有补全和图形调试新手长期用会很痛苦Kotlin Playground网页快速验证一段小代码零安装打开浏览器就能跑做不了完整工程只适合验证和练习我的建议是如果你未来方向明确是 Android直接上 Android Studio省得以后切换环境如果只是学 Kotlin 本身或者走服务端就装 IDEA Community。先把这个核心判断定了后面动手才不纠结。3. Windows环境从零搭建JDK、IDEA与命令行工具完整实操3.1 Windows安装JDK下载、安装和JAVA_HOME配置细节先说下载渠道。打开 adoptium.net选择 JDK 21 的 Windows x64 安装包msi 格式即可。这个站点是 Eclipse Temurin 的官方页面也就是原来 AdoptOpenJDK 的继任项目可靠性没问题许可对开发者也很友好。安装过程中有两个非常容易被忽略的细节。第一安装类型选完整安装并且务必把Set JAVA_HOME variable勾选上。这一步如果漏了之后就得去系统属性里手动配置麻烦但也别怕后面会说。第二记住安装路径。默认的C:\Program Files\Eclipse Adoptium\jdk-21.x.x-x就可以只要路径里没有中文就行。装完验证一下。打开 PowerShell执行java -version如果输出类似openjdk version 21 ...的内容说明 JDK 已经能用了。再执行echo $env:JAVA_HOME如果显示为空说明刚才的 JAVA_HOME 没配上需要手动补右键此电脑→属性→高级系统设置→环境变量在系统变量里新建JAVA_HOME值指向 JDK 安装路径再把%JAVA_HOME%\bin追加到Path变量中。这里多说一句如果你打算只在 IDEA 里写代码不碰命令行那 JAVA_HOME 不配也能开发。但我还是建议配好因为后面你要跑 kotlinc、执行 Gradle 命令、排查问题的时候没有它会有很多额外麻烦。3.2 安装IntelliJ IDEA Community并确认Kotlin支持去 jetbrains.com/idea 下载 Community Edition 的 Windows 安装包安装过程基本一路下一步。唯一要注意的是安装选项里把Update PATH variable和Create associations勾上这样以后右键文件夹就能直接用 IDEA 打开。第一次启动时会有导入配置的提示选Do not import settings就好。到了这一步很多人会去找 Kotlin 插件其实现在的 IntelliJ IDEA 本身就有 Kotlin 开发支持新版本基本不需要手动装插件。如果确实没看到 Kotlin 相关选项去 Plugins 市场搜 Kotlin 安装一下即可。想确认 Kotlin 环境就绪最简单的办法是在欢迎界面点 New Project看左侧有没有 Kotlin 分类。有就说明一切正常。3.3 macOS与Linux用户的环境差异提示虽然这篇文章以 Windows 为主线但 Kotlin 的跨平台属性决定了大量开发者是在 macOS 和 Linux 上工作的这里集中说下差异。macOS 现在大多是 Apple Silicon 芯片安装 Temurin 时记得选 macOS aarch64 版本。配环境变量不是去图形界面而是在~/.zshrc里追加一行export JAVA_HOME$(/usr/libexec/java_home -v 21)然后执行source ~/.zshrc使其生效。Linux 用户最简单的方式是用包管理器比如 Ubuntusudo apt update sudo apt install openjdk-21-jdkIDEA 的安装我推荐用 JetBrains Toolbox 统一管理升级和回滚都很方便比手动下载 tar.gz 解压省心得多。3.4 环境验证清单装完了怎么判断成功我把环境装完之后习惯按这个清单快速过一遍全部通过才敢说环境搭好了。java -version能输出版本号并且不是 8IDEA 新建项目时能自动识别到 JDK不需要手动导入路径在 IDEA 的 Terminal 里执行kotlin -version能输出 Kotlin 版本号随便建一个空的 Kotlin 工程即使没有写代码也能正常编译。如果第 2 条没过多半是 IDEA 没扫到 JDK可以在 File → Project Structure → SDK 里手动添加 JDK 路径。如果第 3 条没过说明 PATH 有问题回到上一小节检查环境变量。前三条都过了整个环境基本就是健康的。4. 第一个Kotlin项目手写Hello World并理解运行全过程4.1 创建工程IDEA里New Project到底怎么选第一次用 IDEA 的 New Project 向导很容易被左侧的分类吓到。Java、Gradle、IntelliJ Platform Plugin、Empty Project一排选项到底选哪个我的答案是学 Kotlin 语言本身选择New Project → Kotlin → JVM | IDEA然后 Next。这个选项的含义是创建一个由 IDEA 自己的构建管理工具管理的纯 Kotlin JVM 工程不牵涉 Gradle 和 Maven创建速度快对新手最友好。等以后你真正做项目了再造 Gradle 工程不迟入门阶段不必给自己上难度。接下来是 Project SDK 下拉框正常情况下会自动带出你刚装的 JDK保持默认即可。如果你看到下拉框是空的说明 JDK 环境没配好回第三章检查。最后给项目起个名字比如kotlin-starter点 Finish。创建成功后IDEA 会自动生成一个src目录里面有一个Main.kt文件这就是整个项目的入口源文件。4.2 写Hello World五行代码背后是Kotlin的设计哲学打开Main.kt把默认内容删掉写上一段 Kotlin 入门最经典的代码fun main() { println(Hello, World!) }别看它只有两行这已经暗示了 Kotlin 和 Java 的核心差异入口函数不需要类。Java 必须写public class Main再套一层public static void main而 Kotlin 直接用顶层函数就解决了。代码量相差一倍不止。稍微加点东西感受一下 Kotlin 的变量声明fun main() { val message Hello, World! println(message) println(这是 Kotlin 的 val 变量声明后不可重新赋值) }val表示不可变引用相当于 Java 里的 final。Kotlin 的设计哲学是默认不可变只有确实需要修改时才用var。在第一个程序里就体现出了这种理念后面学集合、学并发时会反复遇到同样的思路。4.3 点击Run之后IDEA到底帮你做了什么写好代码后编辑区左侧会出现一个绿色三角形图标点击它选Run MainKt控制台就会输出Hello, World!。这一步背后发生的事情我建议每个新手都理解一遍。IDEA 先调用 Kotlin 编译器把Main.kt编译成.class字节码文件再启动 JVM加载字节码执行main函数。你可以在项目根目录下找到out目录里面就是编译产物也可以在 Build 窗口看到完整的编译日志。为什么要理解这个过程因为等将来你遇到代码看着没问题但跑不起来的报错时如果能先判断问题出在编译阶段还是运行阶段排查效率会高很多。很多网上求助的人连这个基本分层都没想过只会贴一大段报错让人猜。4.4 完全绕过IDE用kotlinc命令行跑一遍如果你想彻底搞懂 Kotlin 工具链强烈建议手动跑一次命令行编译。在 IDEA 自带的 Terminal 里或者系统的 cmd 里执行kotlinc hello.kt -include-runtime -d hello.jar这条命令把hello.kt编译成可以直接运行的 jar 包-include-runtime表示把 Kotlin 运行时一起打进去这样目标机器上不需要额外装 Kotlin 库就能跑。然后执行java -jar hello.jar你会在命令行看到和 IDEA 里一模一样的输出。需要提醒的是IDEA 自带的 Kotlin 插件用的是内部编译器不会把kotlinc命令放到 PATH 里。如果你想要命令行体验需要单独去 JetBrains 官网下载 Kotlin 编译器解压后把kotlinc/bin加到环境变量。这一步对纯 IDEA 用户不是必须的但我建议做一下因为它能帮你从IDE 的神秘魔法里走出来真正看清 Kotlin 的编译与执行链路。5. 踩坑实录环境搭建和Hello World阶段的高频问题与排查链路5.1 JDK已安装却提示找不到SDK排在第一的高频问题明明装了 JDK但 IDEA 就是报找不到 SDK或者项目 SDK 下拉框是空的。我的排查顺序是固定的。先在命令行执行java -version。如果报java 不是内部或外部命令说明 JDK 压根没进 PATH问题出在安装或者环境变量上回到第 3.1 节重新检查。如果命令行能正常输出版本号但 IDEA 不认说明 IDE 没去默认路径扫描打开 File → Project Structure → Project → SDK → Add JDK手动导航到 JDK 安装目录即可。还有一种隐蔽的情况机器上装了多个 JDK。同时存在 JDK 8 和 JDK 21 时IDEA 可能选中旧版本而 Kotlin 编译器要求的版本和旧 JDK 不兼容就会出现各种诡异的错误。解决办法是把旧版本卸载干净只保留一个。5.2 Error: Could not find or load main class的根因这个报错在新手里出现频率极高代码长得和 Hello World 一模一样一运行就报错。我排查过很多例结论是绝大多数时候问题不在代码而在运行配置。比如你之前创建过多个.kt文件或者移动过项目目录IDEA 记住的 Run Configuration 可能还是指向旧入口。你改了代码再点 Run它实际上还在执行别的类。解决办法是进入 Run → Edit Configurations检查 Main class 是否指向当前文件的入口类拿不准就直接删掉旧配置重新 Run 一次。如果项目是移动过位置的.idea目录里的配置信息可能已经错乱重启 IDEA 或者 File → Invalidate Caches / Restart 能解决大部分缓存型故障。5.3 中文用户名和中文路径引发的连锁问题这是中文技术社区里特别常见、教程里却很少提的坑。Windows 用户名是中文的情况下默认用户目录是C:\Users\张三某些构建工具真处理不了非 ASCII 路径轻则构建缓慢重则直接编译失败。我不建议通过改系统用户名来解决Windows 改用户名会引发一连串权限和路径问题代价太大。最稳妥的做法是把开发目录整体放到纯英文路径下比如D:\dev\kotlin-starter。同时把 Gradle 的用户目录.gradle也设置到英文路径。这个土办法实测能解决掉九成以上的诡异错误我之前带的一位学员就是被这问题困了一整天换了英文路径后立刻干净。5.4 Gradle下载慢或同步失败的预防性处理虽然前面我们的 Hello World 用的是 IDEA 自带构建系统不涉及 Gradle但只要你未来碰 Android 或服务端项目Gradle 就是绕不开的坎。这里先给你打个预防针。Gradle 第一次同步项目时会去拉取整个构建环境和依赖在某些网络环境下经常慢到让人怀疑人生。解决思路有两步第一把新建项目时的 Gradle 仓库源替换为阿里云公共仓库镜像地址第二在gradle.properties里加大构建内存org.gradle.jvmargs-Xmx4g这两条可以极大改善第一次同步的体验。更详细的 Gradle 主题以后单开一篇展开这里你只要记住镜像源和jvmargs这两个关键词遇到同步问题时就想起这两个方向。6. Hello World之后给Kotlin新人的梯度学习建议6.1 先练最小可运行单元再铺开语法我见过太多人一上来就去背 Kotlin 的语法清单when 表达式、数据类、密封类、扩展函数背得滚瓜烂熟结果一打开 IDE 实操二十分钟过去了还在对着空文件发呆。我的建议正相反先反复练习新建文件 → 写 main 函数 → 用 println 输出结果 → 运行这个最小闭环练到不用思考就能完成。你会发现之后学任何新语法都是在这个闭环里加一行测试代码的问题。比如学变量时写fun main() { val name Kotlin var count 1 count println($name 学了 $count 次) }学集合操作时写fun main() { val numbers listOf(1, 2, 3, 4, 5) val doubled numbers.map { it * 2 } println(doubled) }每学一个新知识点就在 main 函数里跑一个最小示例验证跑完看到输出你就真正掌握了。这比任何课程视频都有效。6.2 协程、Android与KMP三条后续路线怎么选从社区热度和搜索趋势看Kotlin 学习者在 Hello World 之后的下一站通常是三个方向协程、Android、Kotlin Multiplatform。协程我认为所有人都应该学它不只是异步框架更是理解 Kotlin 挂起函数和结构化并发的钥匙。我实际项目里遇到的大多数疑难 bug都和协程作用域、调度器使用不当有关。入门阶段先把它理解成轻量级线程就够了后面再看官方文档的 Coroutines Guide。Android 是就业导向最强的选择这时候就该装 Android Studio配合模拟器写 UI。环境上比纯 Kotlin 多了一套 Android SDK 和模拟器的成本但体系成熟资料最多。KMP 更适合有一定开发经验的人用一套 Kotlin 逻辑同时对接 iOS 和 Android收益很可观。但入门阶段不建议一上来就研究 KMP先把 JVM 平台的 Kotlin 基础打牢后续切换成本极低。6.3 我常用的第一周练习清单最后分享一份我带新人时常用的第一周练习清单强度不高但能覆盖 Kotlin 八成的基础语法用val和var声明不同类型变量体会类型推导写三个函数无参数、单参数、带默认参数理解顶层函数用listOf造一个列表分别用 for 循环和forEach遍历用when表达式写一个成绩等级判断对比它和 Java switch 的差异自定义一个 data class观察它自动生成的toString、equals和copy在 Kotlin Playground 里把官方文档的入门示例逐个跑一遍。按我教新人的经验这六项全部完成后你对 Kotlin 的手感就有了后面再学任何进阶主题都会顺畅得多。我自己带过的每位新人都是从这份清单起的步效果比一上来啃大部头要好太多。环境搭好了代码跑起来了这门语言接下来会越学越顺。下一篇我会直接讲 Kotlin 的核心语法从变量、控制流到函数式特性咱们到时候见。
Kotlin环境搭建从零到跑通：JDK选型与IDEA实战指南
1. 为什么环境搭建是Kotlin入门的第一道坎1.1 Kotlin早就不是一门Android专有语言了很多人的印象还停留在Kotlin 是写 Android 用的但 2025 年的 Kotlin 生态早就超出了这个范畴。它运行在 JVM 上所以服务端开发、桌面工具、命令行脚本都能写Google 在 2017 年就把它扶正为 Android 官方一级开发语言现在新项目默认就是 Kotlin而 JetBrains 这几年押注的 Kotlin Multiplatform 更是把目标伸向 iOS、JS 和原生平台。这就带出一个关键判断你学 Kotlin 的最终目标决定了你该搭哪一套环境。如果目标是 Android老老实实装 Android Studio因为它自带 Kotlin 插件、Android SDK 和模拟器链路是完整的如果目标只是学会这门语言本身或者打算走服务端路线装 IntelliJ IDEA Community 版就够了轻量、免费、干净环境链路短不容易出幺蛾子。这篇文章的主线我放在 IDEA Community 上因为这个选择覆盖人群最广也是最不容易走弯路的一条路。1.2 多数入门者不是被语法难倒而是被环境卡住我带过不少新人发现一个挺反直觉的规律凡是说Kotlin 太难的人十个里有九个是栽在环境上而不是语法上。Kotlin 的语法在主流语言里算相当友好的变量声明、空安全、集合操作都直白到几乎没有理解门槛。真正劝退人的是这些问题JDK 装了但版本不对Kotlin 编译器报一堆看不懂的错环境变量没配好命令行认识 java 但 IDEA 不认或者网上教程版本太老JDK 8 时代的步骤拿到 JDK 17/21 上根本不适用。尤其是最后一个问题。很多老教程还在教你去 Oracle 官网下载 JDK、注册账号这已经跟不上现在的玩法了。社区现在的默认选择是 Eclipse Temurin、Azul Zulu 这些 OpenJDK 发行版免费且许可干净。所以环境搭建从来不只是装个软件它背后是一套选型逻辑。这套逻辑今天搞清楚了后面不管学协程、接触 Gradle、还是切到 Android Studio你都有一套自己的判断标准不会再被教程牵着鼻子走。2. 动手前的必修课JDK、JVM和Kotlin工具链到底是谁在干活2.1 一句话讲清楚JDK、JVM与Kotlin编译器的分工新手最常问的一个问题我学 Kotlin为什么要装 Java 的东西这个疑惑不解决后面每一步都会带着别扭。其实关系非常简单。JVMJava Virtual MachineJava虚拟机是一个运行环境负责执行字节码。Kotlin 代码编译之后生成的也是 JVM 字节码所以 Kotlin 天然依赖 JVM 才能跑起来。JDKJava Development Kit是一整套开发工具箱里面包含 JVM、编译器、调试工具和庞大的类库。没有 JDKKotlin 编译器和运行时都找不到灶台。Kotlin 编译器kotlinc负责把.kt源文件编译成.class字节码文件再把运行权交给 JVM。打个比方JDK 是一间完整的厨房JVM 是灶台kotlinc 是切菜师傅。你不可能跳过切菜师傅把生菜直接丢到灶台上就端出菜来。所以搭 Kotlin 环境的第一步永远是装 JDK而不是先装 IDEA 或 kotlinc。顺序一旦反了后面经常会卡在为什么 IDEA 里找不到 JDK这类问题上。2.2 JDK选型11、17还是21关于 JDK 版本我给新手的建议非常明确优先 JDK 17 或 JDK 21别再用 8 和 11除非公司项目有历史包袱。现在网上常见的问题恰恰是照着老教程装了 JDK 8然后发现 Kotlin 编译器报Unsupported class file major version之类的错根本原因就是 JDK 版本和工具链不匹配。JDK 版本维护状态推荐度说明JDK 8停止免费更新不推荐只存在于历史项目和大量旧教程中新项目完全没必要JDK 11维护晚期一般如果团队锁定了这个版本可以接受否则跳过JDK 17LTS维护良好推荐当前最稳妥的选择Kotlin、Gradle、IDEA 都支持得很完善JDK 21LTS当前主流推荐2025 年新项目无脑选这个性能和特性都有保障JDK 17 和 21 对 Kotlin 入门阶段的体感差异几乎为零所以你不必纠结太多。只要避开 JDK 8机器上装 21 就是最省心的选择。2.3 IDE与命令行四种可行方案的取舍Kotlin 官方推荐的 IDE 是 IntelliJ IDEA但现实里方案不止一种。我列个表方便你根据自己的实际情况做决定。方案适用场景优点缺点IntelliJ IDEA Community通用学习、服务端、桌面开发免费、Kotlin 支持开箱即用、补全和调试体验极佳不支持 Android 开发Android StudioAndroid 方向官方 Kotlin 支持完整模拟器、真机调试链路齐全体积很大纯学 Kotlin 略显笨重kotlinc 编辑器命令行玩家极轻量能真正理解编译链条没有补全和图形调试新手长期用会很痛苦Kotlin Playground网页快速验证一段小代码零安装打开浏览器就能跑做不了完整工程只适合验证和练习我的建议是如果你未来方向明确是 Android直接上 Android Studio省得以后切换环境如果只是学 Kotlin 本身或者走服务端就装 IDEA Community。先把这个核心判断定了后面动手才不纠结。3. Windows环境从零搭建JDK、IDEA与命令行工具完整实操3.1 Windows安装JDK下载、安装和JAVA_HOME配置细节先说下载渠道。打开 adoptium.net选择 JDK 21 的 Windows x64 安装包msi 格式即可。这个站点是 Eclipse Temurin 的官方页面也就是原来 AdoptOpenJDK 的继任项目可靠性没问题许可对开发者也很友好。安装过程中有两个非常容易被忽略的细节。第一安装类型选完整安装并且务必把Set JAVA_HOME variable勾选上。这一步如果漏了之后就得去系统属性里手动配置麻烦但也别怕后面会说。第二记住安装路径。默认的C:\Program Files\Eclipse Adoptium\jdk-21.x.x-x就可以只要路径里没有中文就行。装完验证一下。打开 PowerShell执行java -version如果输出类似openjdk version 21 ...的内容说明 JDK 已经能用了。再执行echo $env:JAVA_HOME如果显示为空说明刚才的 JAVA_HOME 没配上需要手动补右键此电脑→属性→高级系统设置→环境变量在系统变量里新建JAVA_HOME值指向 JDK 安装路径再把%JAVA_HOME%\bin追加到Path变量中。这里多说一句如果你打算只在 IDEA 里写代码不碰命令行那 JAVA_HOME 不配也能开发。但我还是建议配好因为后面你要跑 kotlinc、执行 Gradle 命令、排查问题的时候没有它会有很多额外麻烦。3.2 安装IntelliJ IDEA Community并确认Kotlin支持去 jetbrains.com/idea 下载 Community Edition 的 Windows 安装包安装过程基本一路下一步。唯一要注意的是安装选项里把Update PATH variable和Create associations勾上这样以后右键文件夹就能直接用 IDEA 打开。第一次启动时会有导入配置的提示选Do not import settings就好。到了这一步很多人会去找 Kotlin 插件其实现在的 IntelliJ IDEA 本身就有 Kotlin 开发支持新版本基本不需要手动装插件。如果确实没看到 Kotlin 相关选项去 Plugins 市场搜 Kotlin 安装一下即可。想确认 Kotlin 环境就绪最简单的办法是在欢迎界面点 New Project看左侧有没有 Kotlin 分类。有就说明一切正常。3.3 macOS与Linux用户的环境差异提示虽然这篇文章以 Windows 为主线但 Kotlin 的跨平台属性决定了大量开发者是在 macOS 和 Linux 上工作的这里集中说下差异。macOS 现在大多是 Apple Silicon 芯片安装 Temurin 时记得选 macOS aarch64 版本。配环境变量不是去图形界面而是在~/.zshrc里追加一行export JAVA_HOME$(/usr/libexec/java_home -v 21)然后执行source ~/.zshrc使其生效。Linux 用户最简单的方式是用包管理器比如 Ubuntusudo apt update sudo apt install openjdk-21-jdkIDEA 的安装我推荐用 JetBrains Toolbox 统一管理升级和回滚都很方便比手动下载 tar.gz 解压省心得多。3.4 环境验证清单装完了怎么判断成功我把环境装完之后习惯按这个清单快速过一遍全部通过才敢说环境搭好了。java -version能输出版本号并且不是 8IDEA 新建项目时能自动识别到 JDK不需要手动导入路径在 IDEA 的 Terminal 里执行kotlin -version能输出 Kotlin 版本号随便建一个空的 Kotlin 工程即使没有写代码也能正常编译。如果第 2 条没过多半是 IDEA 没扫到 JDK可以在 File → Project Structure → SDK 里手动添加 JDK 路径。如果第 3 条没过说明 PATH 有问题回到上一小节检查环境变量。前三条都过了整个环境基本就是健康的。4. 第一个Kotlin项目手写Hello World并理解运行全过程4.1 创建工程IDEA里New Project到底怎么选第一次用 IDEA 的 New Project 向导很容易被左侧的分类吓到。Java、Gradle、IntelliJ Platform Plugin、Empty Project一排选项到底选哪个我的答案是学 Kotlin 语言本身选择New Project → Kotlin → JVM | IDEA然后 Next。这个选项的含义是创建一个由 IDEA 自己的构建管理工具管理的纯 Kotlin JVM 工程不牵涉 Gradle 和 Maven创建速度快对新手最友好。等以后你真正做项目了再造 Gradle 工程不迟入门阶段不必给自己上难度。接下来是 Project SDK 下拉框正常情况下会自动带出你刚装的 JDK保持默认即可。如果你看到下拉框是空的说明 JDK 环境没配好回第三章检查。最后给项目起个名字比如kotlin-starter点 Finish。创建成功后IDEA 会自动生成一个src目录里面有一个Main.kt文件这就是整个项目的入口源文件。4.2 写Hello World五行代码背后是Kotlin的设计哲学打开Main.kt把默认内容删掉写上一段 Kotlin 入门最经典的代码fun main() { println(Hello, World!) }别看它只有两行这已经暗示了 Kotlin 和 Java 的核心差异入口函数不需要类。Java 必须写public class Main再套一层public static void main而 Kotlin 直接用顶层函数就解决了。代码量相差一倍不止。稍微加点东西感受一下 Kotlin 的变量声明fun main() { val message Hello, World! println(message) println(这是 Kotlin 的 val 变量声明后不可重新赋值) }val表示不可变引用相当于 Java 里的 final。Kotlin 的设计哲学是默认不可变只有确实需要修改时才用var。在第一个程序里就体现出了这种理念后面学集合、学并发时会反复遇到同样的思路。4.3 点击Run之后IDEA到底帮你做了什么写好代码后编辑区左侧会出现一个绿色三角形图标点击它选Run MainKt控制台就会输出Hello, World!。这一步背后发生的事情我建议每个新手都理解一遍。IDEA 先调用 Kotlin 编译器把Main.kt编译成.class字节码文件再启动 JVM加载字节码执行main函数。你可以在项目根目录下找到out目录里面就是编译产物也可以在 Build 窗口看到完整的编译日志。为什么要理解这个过程因为等将来你遇到代码看着没问题但跑不起来的报错时如果能先判断问题出在编译阶段还是运行阶段排查效率会高很多。很多网上求助的人连这个基本分层都没想过只会贴一大段报错让人猜。4.4 完全绕过IDE用kotlinc命令行跑一遍如果你想彻底搞懂 Kotlin 工具链强烈建议手动跑一次命令行编译。在 IDEA 自带的 Terminal 里或者系统的 cmd 里执行kotlinc hello.kt -include-runtime -d hello.jar这条命令把hello.kt编译成可以直接运行的 jar 包-include-runtime表示把 Kotlin 运行时一起打进去这样目标机器上不需要额外装 Kotlin 库就能跑。然后执行java -jar hello.jar你会在命令行看到和 IDEA 里一模一样的输出。需要提醒的是IDEA 自带的 Kotlin 插件用的是内部编译器不会把kotlinc命令放到 PATH 里。如果你想要命令行体验需要单独去 JetBrains 官网下载 Kotlin 编译器解压后把kotlinc/bin加到环境变量。这一步对纯 IDEA 用户不是必须的但我建议做一下因为它能帮你从IDE 的神秘魔法里走出来真正看清 Kotlin 的编译与执行链路。5. 踩坑实录环境搭建和Hello World阶段的高频问题与排查链路5.1 JDK已安装却提示找不到SDK排在第一的高频问题明明装了 JDK但 IDEA 就是报找不到 SDK或者项目 SDK 下拉框是空的。我的排查顺序是固定的。先在命令行执行java -version。如果报java 不是内部或外部命令说明 JDK 压根没进 PATH问题出在安装或者环境变量上回到第 3.1 节重新检查。如果命令行能正常输出版本号但 IDEA 不认说明 IDE 没去默认路径扫描打开 File → Project Structure → Project → SDK → Add JDK手动导航到 JDK 安装目录即可。还有一种隐蔽的情况机器上装了多个 JDK。同时存在 JDK 8 和 JDK 21 时IDEA 可能选中旧版本而 Kotlin 编译器要求的版本和旧 JDK 不兼容就会出现各种诡异的错误。解决办法是把旧版本卸载干净只保留一个。5.2 Error: Could not find or load main class的根因这个报错在新手里出现频率极高代码长得和 Hello World 一模一样一运行就报错。我排查过很多例结论是绝大多数时候问题不在代码而在运行配置。比如你之前创建过多个.kt文件或者移动过项目目录IDEA 记住的 Run Configuration 可能还是指向旧入口。你改了代码再点 Run它实际上还在执行别的类。解决办法是进入 Run → Edit Configurations检查 Main class 是否指向当前文件的入口类拿不准就直接删掉旧配置重新 Run 一次。如果项目是移动过位置的.idea目录里的配置信息可能已经错乱重启 IDEA 或者 File → Invalidate Caches / Restart 能解决大部分缓存型故障。5.3 中文用户名和中文路径引发的连锁问题这是中文技术社区里特别常见、教程里却很少提的坑。Windows 用户名是中文的情况下默认用户目录是C:\Users\张三某些构建工具真处理不了非 ASCII 路径轻则构建缓慢重则直接编译失败。我不建议通过改系统用户名来解决Windows 改用户名会引发一连串权限和路径问题代价太大。最稳妥的做法是把开发目录整体放到纯英文路径下比如D:\dev\kotlin-starter。同时把 Gradle 的用户目录.gradle也设置到英文路径。这个土办法实测能解决掉九成以上的诡异错误我之前带的一位学员就是被这问题困了一整天换了英文路径后立刻干净。5.4 Gradle下载慢或同步失败的预防性处理虽然前面我们的 Hello World 用的是 IDEA 自带构建系统不涉及 Gradle但只要你未来碰 Android 或服务端项目Gradle 就是绕不开的坎。这里先给你打个预防针。Gradle 第一次同步项目时会去拉取整个构建环境和依赖在某些网络环境下经常慢到让人怀疑人生。解决思路有两步第一把新建项目时的 Gradle 仓库源替换为阿里云公共仓库镜像地址第二在gradle.properties里加大构建内存org.gradle.jvmargs-Xmx4g这两条可以极大改善第一次同步的体验。更详细的 Gradle 主题以后单开一篇展开这里你只要记住镜像源和jvmargs这两个关键词遇到同步问题时就想起这两个方向。6. Hello World之后给Kotlin新人的梯度学习建议6.1 先练最小可运行单元再铺开语法我见过太多人一上来就去背 Kotlin 的语法清单when 表达式、数据类、密封类、扩展函数背得滚瓜烂熟结果一打开 IDE 实操二十分钟过去了还在对着空文件发呆。我的建议正相反先反复练习新建文件 → 写 main 函数 → 用 println 输出结果 → 运行这个最小闭环练到不用思考就能完成。你会发现之后学任何新语法都是在这个闭环里加一行测试代码的问题。比如学变量时写fun main() { val name Kotlin var count 1 count println($name 学了 $count 次) }学集合操作时写fun main() { val numbers listOf(1, 2, 3, 4, 5) val doubled numbers.map { it * 2 } println(doubled) }每学一个新知识点就在 main 函数里跑一个最小示例验证跑完看到输出你就真正掌握了。这比任何课程视频都有效。6.2 协程、Android与KMP三条后续路线怎么选从社区热度和搜索趋势看Kotlin 学习者在 Hello World 之后的下一站通常是三个方向协程、Android、Kotlin Multiplatform。协程我认为所有人都应该学它不只是异步框架更是理解 Kotlin 挂起函数和结构化并发的钥匙。我实际项目里遇到的大多数疑难 bug都和协程作用域、调度器使用不当有关。入门阶段先把它理解成轻量级线程就够了后面再看官方文档的 Coroutines Guide。Android 是就业导向最强的选择这时候就该装 Android Studio配合模拟器写 UI。环境上比纯 Kotlin 多了一套 Android SDK 和模拟器的成本但体系成熟资料最多。KMP 更适合有一定开发经验的人用一套 Kotlin 逻辑同时对接 iOS 和 Android收益很可观。但入门阶段不建议一上来就研究 KMP先把 JVM 平台的 Kotlin 基础打牢后续切换成本极低。6.3 我常用的第一周练习清单最后分享一份我带新人时常用的第一周练习清单强度不高但能覆盖 Kotlin 八成的基础语法用val和var声明不同类型变量体会类型推导写三个函数无参数、单参数、带默认参数理解顶层函数用listOf造一个列表分别用 for 循环和forEach遍历用when表达式写一个成绩等级判断对比它和 Java switch 的差异自定义一个 data class观察它自动生成的toString、equals和copy在 Kotlin Playground 里把官方文档的入门示例逐个跑一遍。按我教新人的经验这六项全部完成后你对 Kotlin 的手感就有了后面再学任何进阶主题都会顺畅得多。我自己带过的每位新人都是从这份清单起的步效果比一上来啃大部头要好太多。环境搭好了代码跑起来了这门语言接下来会越学越顺。下一篇我会直接讲 Kotlin 的核心语法从变量、控制流到函数式特性咱们到时候见。
