# 开始使用 Kotlin

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

IntelliJ IDEA 提供顶级支持 Kotlin。 它包括 Kotlin 特定的项目模板、代码辅助、重构、调试、分析工具等。 大多数 Java 工具都可以用于 Kotlin，因此，例如，如果您知道如何使用 Java 调试器或重构，您的经验将足以在 Kotlin 中使用这些工具。 在本主题中，您将找到在 IntelliJ IDEA 中开始使用 Kotlin 的说明。

> **Note:**
> 此页面涵盖 IntelliJ IDEA 中的 Kotlin 支持。 有关该语言本身的信息，请参阅 [Kotlin 文档](https://kotlinlang.org/docs/home.html)。

如果您想直接在收件箱中获取所有 Kotlin 新闻，请务必订阅 [Kotlin newsletter](https://lp.jetbrains.com/subscribe-to-kotlin-news/)。

[Video](https://www.youtube.com/v/0bfEO6z-Bgs)

Procedure: 启用 Kotlin 插件

此功能性依赖于 [Kotlin](https://plugins.jetbrains.com/plugin/6954-kotlin) 插件，该插件默认在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用，请确保您没有禁用插件。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  Kotlin  插件并点击   启用  。

> **Tip:**
> 要创建一个 [Kotlin 多平台项目](https://www.jetbrains.com.cn/kotlin-multiplatform/)，请参阅 [Kotlin 多平台快速入门](https://www.jetbrains.com.cn/help/kotlin-multiplatform-dev/quickstart.html)指南。 您可以根据您的需求选择一个或多个平台。

## 创建 Kotlin 项目

这是一个没有特定框架的通用项目。 您可以随时添加所需的框架和技术。

Procedure:

1. 启动 IntelliJ IDEA。

在 IntelliJ IDEA 主屏幕上，点击  `新建 | 项目` 。 如果已经打开了项目，请从主菜单中选择  `文件 | 新建项目` 。

2. 在左侧列表中，选择   Kotlin  。

3. 为新项目命名，并在必要时更改其位置。

4. 选中   创建 Git 仓库   复选框，将新项目置于版本控制之下。

您也可以随时在之后进行此操作。

![创建新项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kotlin-new-project-idea.png)

5. 请选择   IntelliJ   构建系统。 它是一个本地构建器，无需下载其他工件。

如果您想创建一个需要进一步配置的更复杂的项目，请选择 [Maven](maven-support.html) 或 [Gradle](gradle.html)。 对于 Gradle，选择构建脚本的语言：Groovy 或 Kotlin。

6. 从    JDK    列表中选择您想在项目中使用的 [JDK](sdk.html#jdk)。

* 如果已在计算机上安装 JDK，但未在 IDE 中定义，请选择 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.nodes.jdk.png) 从磁盘添加 JDK… 并指定 JDK 主目录的路径。​

* 如果您的计算机上没有必要的 JDK，请选择 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.download.svg) 下载 JDK 。

> **Tip:**
> 如果您不知道选择哪个发行版，并且没有具体要求使用现有的某个发行版，请使用 Oracle OpenJDK。

有关 JDK 及其安装的更多信息，请参阅 [Java 开发工具包 (JDK) 指南](sdk.html#jdk)。

7. 启用   添加示例代码   选项以创建包含示例  `Hello World!`  应用程序的文件。

8. 点击   创建  。

创建项目后，您可以开始编写 Kotlin 代码。 请参阅 [创建您的第一个 Kotlin 应用](create-your-first-kotlin-app.html#write-code)教程以快速上手。

## 在一个项目中混合使用 Java 和 Kotlin

您可以从 Kotlin 调用 Java 代码，反之亦然。 这使您能够逐步将项目转向 Kotlin 或同时使用两种语言，例如使用 Kotlin 测试现有的 Java 代码库。

> **Note:**
> 本文未涉及 Kotlin/Java 语言级别互操作的特殊性。 如需更多信息，请参阅 Kotlin 语言文档中的 [Calling Java from Kotlin](https://kotlinlang.org/docs/java-interop.html)和 [Calling Kotlin from Java](https://kotlinlang.org/docs/java-to-kotlin-interop.html)。

为了在您的项目中开始使用 Kotlin，请确保 Kotlin 插件已启用并且已将 Kotlin 依赖项添加到您的项目中。

Procedure: 将 Kotlin 依赖项添加到现有的 JVM 项目

* 如果您的项目使用 IntelliJ IDEA 构建工具，它会自动添加 Kotlin 依赖项。 第一次在项目中创建 Kotlin 文件时，会出现通知以确认 Kotlin 配置已就绪。

* 对于其他构建工具，请按照以下步骤操作：

* [Gradle](https://kotlinlang.org/docs/gradle.html)

* [Maven](https://kotlinlang.org/docs/maven.html)

## 将 Java 转换为 Kotlin

### 使用 IDE 工具转换代码

Procedure:

IntelliJ IDEA 允许您自动将 Java 代码转换为 Kotlin。 生成的代码并不完美，但在某些情况下可能会有所帮助。

如果您对转换结果不满意，可以使用 `Ctrl+Z` (Windows), `⌘ Z` (macOS), `⌘ Z` (IntelliJ IDEA Classic (macOS)), `⌘ Z` (macOS System Shortcuts), `Ctrl+Z` (XWin), `Ctrl+Z` (GNOME), `Ctrl+Z` (KDE), `Ctrl+Shift+Minus` (Emacs), `Ctrl+Z` (Sublime Text), `⌘ Z` (Sublime Text (macOS)), `Ctrl+Z` (Visual Studio), `⌘ Z` (Visual Studio (macOS)), `Ctrl+Z` (NetBeans), `Ctrl+Z` (Eclipse), `⌘ Z` (Eclipse (macOS))将其回滚。

* 在 Kotlin 文件中粘贴 Java 代码。 在出现的对话框中，点击   是  。

* 在编辑器中打开 Java 文件，转到主菜单并选择  `编码 | 将 Java 转换为 Kotlin` 或按 `Ctrl+Alt+Shift+K` (Windows), `⌘ ⌥ ⇧ K` (macOS), `⌘ ⌥ ⇧ K` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ⇧ K` (macOS System Shortcuts), `Ctrl+Alt+Shift+K` (XWin), `Ctrl+Alt+Shift+K` (GNOME), `Ctrl+Alt+Shift+K` (KDE), `Ctrl+Alt+Shift+K` (Emacs), `Ctrl+Alt+Shift+K` (Sublime Text), `⌘ ⌥ ⇧ K` (Sublime Text (macOS)), `Ctrl+Alt+Shift+K` (Visual Studio), `⌘ ⌥ ⇧ K` (Visual Studio (macOS)), `Ctrl+Alt+Shift+K` (NetBeans), `Ctrl+Alt+Shift+K` (Eclipse), `⌘ ⌥ ⇧ K` (Eclipse (macOS))。

### 使用智能体将 Java 转换为 Kotlin

IntelliJ IDEA 捆绑了  `kotlin-tooling-java-to-kotlin`  编码智能体技能，可帮助智能体在保留 Java 源文件行为的同时，将其转换为符合惯用写法的 Kotlin。 该技能提供特定于框架的转换指导。 可帮助智能体处理 Kotlin 特定约定、保留 API 兼容性并验证转换后的代码。

Procedure: 使用技能

* 要将 Java 代码转换为 Kotlin，请让编码智能体执行转换。 智能体可以在适用时自动检测并使用该技能。

还可以使用智能体调用技能的语法来显式调用该技能。 例如，在 Claude Agent 中：

```PLAINTEXT
/kotlin-tooling-java-to-kotlin Convert UserService.java
to idiomatic Kotlin while preserving its behavior

```

Procedure: 启用或禁用技能

* 该技能默认已启用，因此无需显式启用。 要检查其是否已开启，请转到  `设置 | 工具 | 技能`  并找到   kotlin-tooling-java-to-kotlin  。

如果不需要该技能，请点击   禁用  。

Procedure: 将技能安装到代理

该技能安装在 IDE 的内部存储中。 这样，该技能可用于当前 IDE 中的所有项目，并可供受支持的代理使用。 对于外部代理，可以在设置中安装该技能:

1. 转到  `设置 | 工具 | 技能`  并选择   kotlin-tooling-java-to-kotlin  。

2. 点击靠近   禁用  的箭头按钮，然后选择   安装到  并选择 AI 代理。

![显示捆绑的 java-to-kotlin 技能文件描述的设置对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/java-to-kotlin-skill-settings.png)

## See also

### 外部链接

[Java to Kotlin comparison](https://kotlinlang.org/docs/comparison-to-java.html)