llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

开始使用 Kotlin

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

如果您想直接在收件箱中获取所有 Kotlin 新闻,请务必订阅 Kotlin newsletter。

启用 Kotlin 插件

此功能性依赖于 Kotlin 插件,该插件默认在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用,请确保您没有禁用插件。

  1. 按 Ctrl+Alt+S 打开设置,然后选择 插件。

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

创建 Kotlin 项目

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

  1. 启动 IntelliJ IDEA。

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

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

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

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

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

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

    如果您想创建一个需要进一步配置的更复杂的项目,请选择 Maven 或 Gradle。 对于 Gradle,选择构建脚本的语言:Groovy 或 Kotlin。

  6. 从 JDK 列表中选择您想在项目中使用的 JDK。

    • 如果已在计算机上安装 JDK,但未在 IDE 中定义,请选择 从磁盘添加 JDK… 并指定 JDK 主目录的路径。​

    • 如果您的计算机上没有必要的 JDK,请选择 下载 JDK。

    有关 JDK 及其安装的更多信息,请参阅 Java 开发工具包 (JDK) 指南。

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

  8. 点击 创建。

创建项目后,您可以开始编写 Kotlin 代码。 请参阅 创建您的第一个 Kotlin 应用教程以快速上手。

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

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

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

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

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

  • 对于其他构建工具,请按照以下步骤操作:

将 Java 转换为 Kotlin

使用 IDE 工具转换代码

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

如果您对转换结果不满意,可以使用 Ctrl+Z 将其回滚。

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

  • 在编辑器中打开 Java 文件,转到主菜单并选择 编码 | 将 Java 转换为 Kotlin 或按 Ctrl+Alt+Shift+K。

使用智能体将 Java 转换为 Kotlin

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

使用技能

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

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

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

启用或禁用技能

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

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

将技能安装到代理

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

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

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

显示捆绑的 java-to-kotlin 技能文件描述的设置对话框
2026年 11月 3日