Skip to content

开发环境搭建

概述

本章将指导您搭建Kotlin开发环境,包括JDK安装、IDE配置和项目创建。我们将介绍多种开发环境选项,从简单的在线编辑器到完整的IDE配置。

系统要求

最低要求

  • 操作系统: Windows 7+, macOS 10.9+, Linux (任何现代发行版)
  • 内存: 4GB RAM (推荐8GB+)
  • 存储: 2GB可用空间
  • Java: JDK 8或更高版本

推荐配置

  • 内存: 8GB+ RAM
  • 存储: SSD硬盘
  • Java: JDK 11或17 (LTS版本)

安装Java开发工具包 (JDK)

1. 检查现有Java版本

bash
# 检查Java版本
java -version
javac -version

2. 安装JDK

Windows

  1. 访问 Oracle JDKOpenJDK
  2. 下载适合您系统的JDK安装包
  3. 运行安装程序并按照提示完成安装
  4. 配置环境变量:
    • 添加 JAVA_HOME 指向JDK安装目录
    • %JAVA_HOME%\bin 添加到 PATH

macOS

bash
# 使用Homebrew安装
brew install openjdk@17

# 或者下载安装包手动安装

Linux (Ubuntu/Debian)

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

# 验证安装
java -version

开发环境选择

1. IntelliJ IDEA (推荐)

IntelliJ IDEA是Kotlin的官方IDE,提供最佳的Kotlin开发体验。

安装步骤

  1. 访问 JetBrains官网
  2. 下载Community版本(免费)或Ultimate版本
  3. 安装并启动IDEA
  4. Kotlin插件已预装,无需额外配置

创建Kotlin项目

kotlin
// 1. File -> New -> Project
// 2. 选择 "Kotlin" -> "Kotlin/JVM"
// 3. 配置项目名称和位置
// 4. 选择项目SDK (JDK)
// 5. 点击 "Finish"

2. Android Studio

专为Android开发优化,内置Kotlin支持。

安装步骤

  1. 访问 Android开发者网站
  2. 下载并安装Android Studio
  3. 首次启动时会自动下载Android SDK

创建Kotlin Android项目

kotlin
// 1. Start a new Android Studio project
// 2. 选择项目模板
// 3. 在语言选项中选择 "Kotlin"
// 4. 配置项目详情
// 5. 点击 "Finish"

3. Visual Studio Code

轻量级编辑器,适合简单的Kotlin开发。

安装步骤

  1. 安装 Visual Studio Code
  2. 安装Kotlin扩展:
    • 打开扩展面板 (Ctrl+Shift+X)
    • 搜索 "Kotlin Language"
    • 安装官方Kotlin扩展

4. 在线编辑器

适合快速测试和学习。

Kotlin Playground

  • 访问: https://play.kotlinlang.org/
  • 无需安装,直接在浏览器中编写和运行Kotlin代码
  • 支持多种目标平台(JVM、JS、Native)

创建第一个Kotlin项目

使用IntelliJ IDEA

  1. 创建新项目
File -> New -> Project -> Kotlin -> Kotlin/JVM
  1. 项目结构
MyKotlinProject/
├── src/
│   └── main/
│       └── kotlin/
│           └── Main.kt
├── .idea/
├── out/
└── MyKotlinProject.iml
  1. 编写Hello World程序
kotlin
// Main.kt
fun main() {
    println("Hello, Kotlin!")
}
  1. 运行程序
  • 点击代码左侧的绿色三角形
  • 或使用快捷键 Ctrl+Shift+F10 (Windows/Linux) 或 Cmd+Shift+R (macOS)

使用命令行

  1. 创建项目目录
bash
mkdir my-kotlin-project
cd my-kotlin-project
  1. 创建源文件
kotlin
// hello.kt
fun main() {
    println("Hello, Kotlin!")
}
  1. 编译和运行
bash
# 编译
kotlinc hello.kt -include-runtime -d hello.jar

# 运行
java -jar hello.jar

构建工具配置

Gradle (推荐)

build.gradle.kts (Kotlin DSL)

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

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

repositories {
    mavenCentral()
}

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

tasks.test {
    useJUnitPlatform()
}

kotlin {
    jvmToolchain(17)
}

application {
    mainClass.set("MainKt")
}

运行Gradle项目

bash
# 编译
./gradlew build

# 运行
./gradlew run

# 测试
./gradlew test

Maven

pom.xml

xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>kotlin-project</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <kotlin.version>1.9.10</kotlin.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-stdlib</artifactId>
            <version>${kotlin.version}</version>
        </dependency>
    </dependencies>

    <build>
        <sourceDirectory>src/main/kotlin</sourceDirectory>
        <plugins>
            <plugin>
                <groupId>org.jetbrains.kotlin</groupId>
                <artifactId>kotlin-maven-plugin</artifactId>
                <version>${kotlin.version}</version>
                <executions>
                    <execution>
                        <id>compile</id>
                        <phase>compile</phase>
                        <goals>
                            <goal>compile</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

Android开发环境配置

1. 安装Android Studio

按照前面的步骤安装Android Studio。

2. 配置Android SDK

kotlin
// 在Android Studio中:
// Tools -> SDK Manager
// 安装最新的Android SDK和构建工具

3. 创建Android项目

kotlin
// 选择 "Empty Activity"
// 语言选择 "Kotlin"
// API Level 选择 21+ (推荐)

4. 基本Android Kotlin代码

kotlin
// MainActivity.kt
class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        
        // Kotlin Android扩展
        val textView = findViewById<TextView>(R.id.textView)
        textView.text = "Hello, Kotlin Android!"
    }
}

常见问题和解决方案

1. JDK版本问题

bash
# 错误: Kotlin需要JDK 8+
# 解决: 升级JDK版本
java -version  # 检查当前版本

2. 环境变量配置

bash
# Windows
set JAVA_HOME=C:\Program Files\Java\jdk-17
set PATH=%JAVA_HOME%\bin;%PATH%

# macOS/Linux
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
export PATH=$JAVA_HOME/bin:$PATH

3. IDE插件问题

  • 确保Kotlin插件已启用
  • 更新到最新版本
  • 重启IDE

4. 编译错误

kotlin
// 常见错误: 找不到kotlinc命令
// 解决: 安装Kotlin编译器
# 使用SDKMAN
sdk install kotlin

# 使用Homebrew (macOS)
brew install kotlin

验证安装

创建并运行以下测试程序来验证环境配置:

kotlin
// test.kt
fun main() {
    println("Kotlin version: ${KotlinVersion.CURRENT}")
    println("Java version: ${System.getProperty("java.version")}")
    println("Environment setup successful!")
    
    // 测试基本功能
    val numbers = listOf(1, 2, 3, 4, 5)
    val doubled = numbers.map { it * 2 }
    println("Doubled numbers: $doubled")
}

下一步

环境搭建完成后,让我们开始编写第一个Kotlin程序,学习基本语法。

下一章: 快速上手

练习题

  1. 在您的系统上安装JDK和IntelliJ IDEA
  2. 创建一个新的Kotlin项目
  3. 编写并运行"Hello World"程序
  4. 尝试使用Kotlin Playground在线编辑器
  5. 配置Gradle构建文件并运行项目

本站内容仅供学习和研究使用。