Kotlin 环境配置

在开始编写 Kotlin 代码之前，我们需要先配置好开发环境。本章将详细介绍如何安装 JDK、配置 Kotlin 编译器，以及设置常用的开发工具。

Kotlin 运行环境

Kotlin 程序可以在多种环境中运行：

运行环境	说明	适用场景
JVM	编译为 Java 字节码，运行在 JVM 上	服务端开发、Android 开发
Kotlin/JS	编译为 JavaScript	Web 前端开发、Node.js
Kotlin/Native	编译为原生二进制	iOS 开发、嵌入式、无 JVM 环境

对于初学者，我们推荐使用 JVM 方式，这也是最成熟、生态最完善的选择。

安装 JDK

Kotlin 运行在 JVM 上，所以首先需要安装 Java Development Kit（JDK）。

检查是否已安装 JDK

在终端或命令行中输入以下命令检查：

# 检查 Java 版本
java -version

# 检查 JDK 是否已配置
javac -version

如果显示版本信息，说明已经安装了 JDK。建议使用 JDK 17 或更高版本（LTS 版本）。

# 成功安装的输出示例
java version "17.0.8" 2023-07-18 LTS
Java(TM) SE Runtime Environment (build 17.0.8+9-LTS-211)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.8+9-LTS-211, mixed mode, sharing)

安装 JDK

Windows

访问 Adoptium 下载 JDK 17 或更高版本（推荐 Eclipse Temurin 发行版）
运行安装程序，按照提示完成安装
配置环境变量：
- 右键"此电脑" → "属性" → "高级系统设置"
- 点击"环境变量"按钮
- 在"系统变量"区域点击"新建"：
  - 变量名：JAVA_HOME
  - 变量值：C:\Program Files\Eclipse Adoptium\jdk-17.0.8.101-hotspot（你的实际安装路径）
- 编辑系统变量 Path，添加：%JAVA_HOME%\bin
验证安装：

# 打开新的命令提示符窗口
java -version
javac -version

macOS

使用 Homebrew 安装是最简单的方式：

# 如果没有安装 Homebrew，先安装
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 OpenJDK 17
brew install openjdk@17

# 创建符号链接
sudo ln -sfn /usr/local/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk

# 配置环境变量（zsh）
echo 'export PATH="/usr/local/opt/openjdk@17/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 验证安装
java -version

Linux

Ubuntu/Debian：

# 更新包列表
sudo apt update

# 安装 OpenJDK 17
sudo apt install openjdk-17-jdk

# 验证安装
java -version
javac -version

CentOS/RHEL/Fedora：

# 安装 OpenJDK 17
sudo yum install java-17-openjdk-devel

# 或使用 dnf（Fedora）
sudo dnf install java-17-openjdk-devel

# 验证安装
java -version

配置 JAVA_HOME

JAVA_HOME 环境变量告诉系统 JDK 的安装位置，很多工具（如 Gradle、Maven）需要这个变量。

Windows：如上所述，在系统环境变量中设置。

macOS/Linux：在 shell 配置文件中添加：

# 编辑配置文件
nano ~/.zshrc  # macOS zsh
# 或
nano ~/.bashrc  # Linux bash

# 添加以下内容
export JAVA_HOME=$(/usr/libexec/java_home)  # macOS
# 或
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk  # Linux

# 使配置生效
source ~/.zshrc  # 或 source ~/.bashrc

安装 Kotlin 编译器

方式一：使用 IDE（推荐）

对于初学者和日常开发，推荐使用 IntelliJ IDEA 或 Android Studio，它们内置了 Kotlin 支持：

IntelliJ IDEA：

访问 JetBrains 官网下载
选择 Community 版（免费）或 Ultimate 版（付费）
安装并启动
创建新项目时选择 Kotlin 作为语言

Android Studio：

访问 Android 开发者官网下载
安装并启动
Android Studio 内置 Kotlin 支持

IDE 会自动处理 Kotlin 编译器的安装和配置，无需手动干预。

方式二：手动安装 Kotlin 编译器

如果你需要在命令行中使用 Kotlin，可以手动安装编译器。

Windows

访问 Kotlin GitHub Releases 下载编译器压缩包
解压到合适的位置（如 C:\kotlin）
添加到 PATH 环境变量：
- 打开"环境变量"设置
- 编辑系统变量 Path
- 添加：C:\kotlin\bin

macOS / Linux

使用 Homebrew（macOS）：

brew install kotlin

使用 SDKMAN：

# 安装 SDKMAN
curl -s https://get.sdkman.io | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

# 安装 Kotlin
sdk install kotlin

手动安装：

# 下载并解压
cd /opt
sudo curl -s https://github.com/JetBrains/kotlin/releases/download/v1.9.22/kotlin-compiler-1.9.22.zip -o kotlin.zip
sudo unzip kotlin.zip
sudo rm kotlin.zip

# 添加到 PATH
echo 'export PATH="/opt/kotlinc/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

验证 Kotlin 安装

# 检查 Kotlin 编译器版本
kotlinc -version

# 检查 Kotlin 运行时版本
kotlin -version

输出示例：

Kotlin version 1.9.22-release-764 (JRE 17.0.8+9-LTS-211)

开发工具选择

IntelliJ IDEA（推荐）

IntelliJ IDEA 是 JetBrains 出品的 IDE，对 Kotlin 支持最为完善。

主要优势：

官方支持，功能最全面
智能代码补全、重构、导航
内置 Kotlin 编译器和调试器
支持 Gradle、Maven 构建工具
丰富的插件生态

创建第一个 Kotlin 项目：

启动 IntelliJ IDEA
点击 "New Project"
选择左侧 "Kotlin" → "JVM | IDEA"
设置项目名称和位置
选择 JDK（首次需要配置）
点击 "Create"

项目结构：

my-project/
├── src/
│   └── main/
│       └── kotlin/
│           └── Main.kt      # 源代码
├── .idea/                   # IDE 配置
└── my-project.iml          # 项目配置

运行程序：

打开 Main.kt 文件
点击 main 函数左侧的绿色三角形
选择 "Run 'MainKt'"
在底部 "Run" 窗口查看输出

VS Code

如果你更喜欢轻量级编辑器，可以使用 VS Code 配合 Kotlin 插件。

安装步骤：

安装 VS Code
安装 Kotlin 插件：
- 打开 Extensions（快捷键 Ctrl+Shift+X / Cmd+Shift+X）
- 搜索 "Kotlin"
- 安装官方 Kotlin 插件
安装 Kotlin 编译器（如前所述）

特点：

轻量、启动快
支持语法高亮、代码补全
适合小型项目和脚本开发

Android Studio

Android 开发者的首选 IDE，基于 IntelliJ IDEA，专门针对 Android 开发优化。

特点：

Google 官方推荐
内置 Android SDK 和模拟器
完整的 Kotlin 支持
支持 Jetpack Compose

在线开发环境

如果你只是想快速尝试 Kotlin，可以使用在线环境：

平台	地址	特点
Kotlin Playground	play.kotlinlang.org	官方在线编辑器，支持代码分享
JetBrains Academy	hyperskill.org	交互式学习平台
Replit	replit.com	完整的在线 IDE

命令行编译运行

了解命令行编译有助于理解 Kotlin 的工作原理。

编译为 JAR 文件

# 创建项目目录
mkdir hello-kotlin
cd hello-kotlin

# 创建源文件
echo 'fun main() = println("Hello, Kotlin!")' > Hello.kt

# 编译（包含 Kotlin 运行时）
kotlinc Hello.kt -include-runtime -d Hello.jar

# 运行
java -jar Hello.jar

参数说明：

参数	说明
`Hello.kt`	源文件名
`-include-runtime`	将 Kotlin 运行时库打包进 JAR
`-d Hello.jar`	指定输出文件名

编译为 class 文件

# 编译（不包含运行时）
kotlinc Hello.kt

# 生成的 class 文件名规则
# Hello.kt -> HelloKt.class

运行编译后的 class 文件：

# 使用 kotlin 命令
kotlin HelloKt

# 或使用 java 命令（需要 Kotlin 运行时）
java -cp .:kotlin-stdlib.jar HelloKt

使用 Kotlin REPL

REPL（Read-Eval-Print Loop）是交互式编程环境，适合快速测试：

# 启动 REPL
kotlinc

# 在 REPL 中输入代码
>>> val x = 10
>>> println(x * 2)
20
>>> fun greet(name: String) = "Hello, $name!"
>>> greet("Kotlin")
res2: kotlin.String = Hello, Kotlin!

# 查看帮助
>>> :help

# 退出 REPL
>>> :quit

运行 Kotlin 脚本

Kotlin 可以作为脚本语言使用：

// hello.kts
val name = "Kotlin"
println("Hello, $name!")

// 可以使用任何 Kotlin 代码
(1..5).forEach { println(it) }

运行脚本：

kotlin hello.kts

Gradle 构建工具

对于实际项目，推荐使用 Gradle 进行构建管理。Gradle 是 Kotlin 官方推荐的构建工具。

安装 Gradle

macOS：

brew install gradle

Windows/Linux（使用 SDKMAN）：

sdk install gradle

验证安装：

gradle --version

创建 Gradle 项目

方式一：使用 IDE 创建

在 IntelliJ IDEA 中创建项目时选择 "Gradle" 构建系统。

方式二：使用命令行

# 创建项目目录
mkdir my-kotlin-project
cd my-kotlin-project

# 生成 Gradle Wrapper
gradle wrapper --gradle-version 8.5

# 创建目录结构
mkdir -p src/main/kotlin

build.gradle.kts 配置文件

Kotlin DSL 格式的 Gradle 配置：

// build.gradle.kts
plugins {
    kotlin("jvm") version "1.9.22"
    application
}

group = "com.example"
version = "1.0-SNAPSHOT"

repositories {
    mavenCentral()
}

dependencies {
    // Kotlin 标准库
    implementation(kotlin("stdlib"))
    
    // 测试依赖
    testImplementation(kotlin("test"))
}

tasks.test {
    useJUnitPlatform()
}

application {
    mainClass.set("MainKt")
}

项目结构

my-project/
├── build.gradle.kts      # 构建配置
├── settings.gradle.kts   # 项目设置
├── gradle/
│   └── wrapper/
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── gradlew               # Unix 构建脚本
├── gradlew.bat           # Windows 构建脚本
└── src/
    ├── main/
    │   └── kotlin/       # 源代码
    └── test/
        └── kotlin/       # 测试代码

Gradle 常用命令

# 编译项目
./gradlew build

# 运行应用
./gradlew run

# 运行测试
./gradlew test

# 清理构建
./gradlew clean

# 查看所有任务
./gradlew tasks

配置国内镜像

在国内访问 Maven 中央仓库可能较慢，可以配置国内镜像加速下载。

修改 build.gradle.kts

repositories {
    // 阿里云镜像
    maven { url = uri("https://maven.aliyun.com/repository/central/") }
    maven { url = uri("https://maven.aliyun.com/repository/public/") }
    maven { url = uri("https://maven.aliyun.com/repository/google/") }
    
    // 备用：官方仓库
    mavenCentral()
    google()
}

全局配置（推荐）

在 ~/.gradle/init.gradle 文件中配置（对所有项目生效）：

// init.gradle
allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/central/' }
        maven { url 'https://maven.aliyun.com/repository/public/' }
        maven { url 'https://maven.aliyun.com/repository/google/' }
        mavenCentral()
        google()
    }
    
    buildscript {
        repositories {
            maven { url 'https://maven.aliyun.com/repository/central/' }
            maven { url 'https://maven.aliyun.com/repository/public/' }
            maven { url 'https://maven.aliyun.com/repository/google/' }
            mavenCentral()
            google()
        }
    }
}

常见问题

1. JDK 版本问题

问题：提示 JDK 版本不兼容

解决：确保使用 JDK 17 或更高版本。可以在 IDE 中配置项目 JDK：

IntelliJ IDEA：File → Project Structure → Project SDK
或在 build.gradle.kts 中指定：

kotlin {
    jvmToolchain(17)
}

2. Kotlin 编译器找不到

问题：运行 kotlinc 提示"命令未找到"

解决：

确认已安装 Kotlin 编译器
检查 PATH 环境变量是否正确配置
重新打开终端窗口使环境变量生效

3. Gradle 下载慢

问题：Gradle 首次运行时下载依赖很慢

解决：

配置国内镜像（如上所述）
配置 Gradle 代理：

# gradle.properties
systemProp.http.proxyHost=proxy.example.com
systemProp.http.proxyPort=8080
systemProp.https.proxyHost=proxy.example.com
systemProp.https.proxyPort=8080

4. IDE 无法识别 Kotlin 代码

问题：IDE 中 Kotlin 代码没有语法高亮或代码补全

解决：

确认已安装 Kotlin 插件（IntelliJ IDEA 内置）
File → Invalidate Caches / Restart
检查项目 SDK 配置

小结

本章我们学习了：

JDK 安装：Kotlin 运行在 JVM 上，需要安装 JDK 17+
Kotlin 编译器：可以通过 IDE 自动安装或手动安装
开发工具：IntelliJ IDEA（推荐）、VS Code、Android Studio
命令行操作：编译、运行、REPL、脚本模式
Gradle 构建：项目构建和依赖管理
镜像配置：加速国内依赖下载

准备好环境后，下一章我们将编写第一个 Kotlin 程序！

练习

在你的电脑上安装 JDK 17 或更高版本
验证 java -version 和 javac -version 命令
安装 IntelliJ IDEA 并创建一个 Kotlin 项目
尝试使用命令行编译运行 Hello World 程序
配置 Gradle 项目并成功运行

Kotlin 运行环境​

安装 JDK​

检查是否已安装 JDK​

安装 JDK​

Windows​

macOS​

Linux​

配置 JAVA_HOME​

安装 Kotlin 编译器​

方式一：使用 IDE（推荐）​

方式二：手动安装 Kotlin 编译器​

Windows​

macOS / Linux​

验证 Kotlin 安装​

开发工具选择​

IntelliJ IDEA（推荐）​

VS Code​

Android Studio​

在线开发环境​

命令行编译运行​

编译为 JAR 文件​

编译为 class 文件​

使用 Kotlin REPL​

运行 Kotlin 脚本​

Gradle 构建工具​

安装 Gradle​

创建 Gradle 项目​

build.gradle.kts 配置文件​

项目结构​

Gradle 常用命令​

配置国内镜像​

修改 build.gradle.kts​

全局配置（推荐）​

常见问题​

1. JDK 版本问题​

2. Kotlin 编译器找不到​

3. Gradle 下载慢​

4. IDE 无法识别 Kotlin 代码​

小结​

练习​

Kotlin 运行环境

安装 JDK

检查是否已安装 JDK

安装 JDK

Windows

macOS

Linux

配置 JAVA_HOME

安装 Kotlin 编译器

方式一：使用 IDE（推荐）

方式二：手动安装 Kotlin 编译器

Windows

macOS / Linux

验证 Kotlin 安装

开发工具选择

IntelliJ IDEA（推荐）

VS Code

Android Studio

在线开发环境

命令行编译运行

编译为 JAR 文件

编译为 class 文件

使用 Kotlin REPL

运行 Kotlin 脚本

Gradle 构建工具

安装 Gradle

创建 Gradle 项目

build.gradle.kts 配置文件

项目结构

Gradle 常用命令

配置国内镜像

修改 build.gradle.kts

全局配置（推荐）

常见问题

1. JDK 版本问题

2. Kotlin 编译器找不到

3. Gradle 下载慢

4. IDE 无法识别 Kotlin 代码

小结

练习