Kotlin 环境搭建

工欲善其事,必先利其器。本篇带你用三种姿势搭建 Kotlin 开发环境:IntelliJ IDEA(推荐,JetBrains 自家出品)、命令行 + kotlinc(适合脚本玩家)、在线工具(零安装,立刻体验)。整个流程不超过 10 分钟。

1. 前置条件:JDK

Kotlin 编译后跑在 JVM 上,所以必须先装 JDK(Java Development Kit)。版本 8 以上皆可,推荐 JDK 17(长期支持版,Android Studio 也用这个)。检查是否已安装:

# Kotlin 跑在 JVM 上,需要先装 JDK(Java Development Kit)
# 终端验证是否已安装
java -version
# 输出类似:
# openjdk version "17.0.8" 2023-07-18
# OpenJDK Runtime Environment (build 17.0.8+0-jvmci-...)
#
# 如果报 "command not found",需要先安装 JDK

如果没装,去 Adoptium(https://adoptium.net) 下载对应平台的安装包,或用包管理器:brew install openjdk@17(macOS)、sudo apt install openjdk-17-jdk(Ubuntu)、choco install temurin17(Windows)。

2. 方式一:IntelliJ IDEA Community(强烈推荐)

JetBrains 是 Kotlin 的亲爹,IDEA 是体验最佳的 Kotlin IDE,无出其右。Community 版免费开源,功能足够入门。

fun main() {
    println("Hello, Kotlin!")
    val name = "小明"
    println("你好, $name!")
    println("明年 ${2026 - 2024 + 1} 岁了")
}
// 输出:
// Hello, Kotlin!
// 你好, 小明!
// 明年 3 岁了

IDEA 的杀手锏特性:

3. Android 开发者:Android Studio

如果你目标是 Android,Android Studio 是官方 IDE,基于 IntelliJ IDEA 构建,内置 Kotlin 插件,无需额外配置。下载地址:https://developer.android.com/studio。

新建项目时选 Empty Compose Activity(Jetpack Compose 是 Kotlin 写的声明式 UI 框架),即可体验最新的 Android 写法。Android Studio 还自带 Android SDK、模拟器、Layout Inspector,一条龙到位。

4. 方式二:命令行 + kotlinc

不想装笨重的 IDE?用命令行也能完整开发 Kotlin。先装 kotlinc(Kotlin Compiler):

# macOS(用 Homebrew)
brew install kotlin

# Linux(SDKMAN!)
sdk install kotlin

# Windows(用 Chocolatey)
choco install kotlinc

# 验证安装
kotlinc -version
# 输出: kotlinc-jvm 1.9.22 (JRE 17+8)

然后用任意编辑器(VS Code、Vim、Sublime)写代码,命令行编译运行:

# 1. 把代码保存为 hello.kt
#    fun main() {
#        println("Hello, Kotlin!")
#    }

# 2. 编译成 jar(包含 Kotlin 运行时,体积大但可独立运行)
kotlinc hello.kt -include-runtime -jar hello.jar
java -jar hello.jar
# 输出: Hello, Kotlin!

# 3. 编译成 class(不含运行时,需要本机有 Kotlin 库)
kotlinc hello.kt -d out/
# 生成 out/HelloKt.class,用 kotlin 命令跑
kotlin -cp out HelloKt

# 4. 直接执行 Kotlin 脚本(.kts 文件)
kotlinc -script hello.kts

几个关键参数的含义:

注意 kotlinc -script 只对 .kts(Kotlin Script)文件有效,普通 .kt 必须先编译再运行,这点和 Python 的"直接跑源码"不同。

5. 方式三:在线工具(零安装)

如果你只想立刻体验一下 Kotlin,不必装任何东西。下面三个在线工具足够覆盖入门需求:

建议学完每篇教程后,把示例代码贴进 Playground 改一改参数运行,加深理解。

6. 构建工具:Gradle

命令行编译只适合单文件玩具项目。一旦项目变大、依赖第三方库,就必须用构建工具。Kotlin 生态的标配是 Gradle(Maven 也支持,但 Gradle 是首选)。

Kotlin 项目推荐用 Kotlin DSL 写构建脚本(文件名 build.gradle.kts),比传统的 Groovy DSL(build.gradle)有更好的 IDE 补全和类型检查。一个最小化的 JVM 项目脚本如下:

plugins {
    kotlin("jvm") version "1.9.22"
    application
}

application {
    mainClass.set("HelloKt")
}

repositories {
    mavenCentral()
}

dependencies {
    implementation(kotlin("stdlib"))
}

常用 Gradle 命令(./gradlew 是项目自带的 Wrapper 脚本,无需本机预装 Gradle):

Gradle 第一次运行会比较慢(下载依赖),之后会缓存到 ~/.gradle,后续构建几秒到十几秒就能完成。

7. 项目目录结构

一个标准的 Kotlin JVM 项目(用 IDEA 创建时自动生成)长这样:

my-app/
├── build.gradle.kts        # Gradle 构建脚本(Kotlin DSL)
├── settings.gradle.kts     # 项目设置
├── gradle/                 # Gradle Wrapper
├── gradlew                 # Linux/macOS 构建脚本
├── gradlew.bat             # Windows 构建脚本
├── src/
│   ├── main/
│   │   └── kotlin/
│   │       └── Hello.kt    # 你的源码
│   └── test/
│       └── kotlin/
│           └── HelloTest.kt
└── README.md

注意 Kotlin 不像 Java 那样强制"文件名必须等于 public class 名",一个 .kt 文件里可以写多个顶层函数,也可以零 class(只有 main 函数)。但建议一个文件只放一个职责,保持可读性。包名 com.example.hello 对应目录 com/example/hello,这点和 Java 一致。

8. 常见坑与排查

9. IDEA 调试技巧

装好 IDEA 后,调试 Kotlin 代码和 Java 完全一样:

协程调试是 Kotlin 独有的:IDEA 会显示协程视图(Coroutine Dump),可以看到每个协程当前挂在哪一行。这在排查死锁、漏取消协程时极有用。

10. 不同平台的差异提醒

Kotlin 跑在不同平台上有不同的依赖和约束,初学者容易混淆:

本教程所有示例都假设 JVM 平台,这是入门最简单的方式。学完语言基础之后再扩展到 Android 或其他平台。

小结

现在你应该能在本机跑起来 Kotlin 代码了。最省心的组合是 IntelliJ IDEA Community + JDK 17:一键建项目、一键运行、一键调试。如果想轻量试水,直接打开 Playground 即可。下一篇我们正式进入语法部分,讲 Kotlin 的基础语法——程序结构、注释、关键字,看看 Kotlin 代码的"骨架"长什么样。

← 上一篇 Kotlin 语言简介

下一篇 Kotlin 基础语法 →

✈️💬