# SDK

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

一个  Software Development Kit ，或称  SDK ，是您开发特定软件框架应用程序所需的一组工具。 例如，要开发 Java 应用程序，您需要 Java SDK（JDK）。 SDK 包含二进制文件、二进制文件的源代码和源代码的文档。 JDK 版本还包含注解。

通常，SDK 是全局的。 这意味着一个 SDK 可以在多个项目和模块中使用。 创建新项目并为其定义 SDK 后，您可以配置此项目中的模块以继承其 SDK。 您还可以为每个模块单独指定一个 SDK。 如需更多信息，请参阅 [更改模块 SDK](#change-module-sdk)。

[Video](https://www.youtube.com/v/W4EK_KVgfkw)

## 支持的 SDK

* [Java 开发工具包 (JDK)](#jdk)

* [Kotlin SDK](#kotlin_sdk)

* [Android SDK](https://developer.android.com/studio)

* [IntelliJ Platform Plugin SDK](https://plugins.jetbrains.com/docs/intellij/ide-development-instance.html?from=jetbrains.org)

* [JavaFX SDK](https://gluonhq.com/products/javafx/)

* [Grails SDK](https://grails.org/download.html)

## 配置 SDK

将 IntelliJ IDEA 告知您计算机上的哪个文件夹安装了所需的 SDK 版本，称为  定义一个 SDK 。 此文件夹称为  SDK 主目录 。

Procedure: 添加全局 SDK

1. 在主菜单中，前往  `文件 | 项目结构 | 平台设置 | SDK` 。

2. 点击 !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)，然后从计算机上检测到的 SDK 列表中选择所需选项。

3. 仅适用于 JDK：如果 IDE 无法自动在计算机上找到所需的 JDK，请点击   从磁盘添加 JDK  ，并在打开的对话框中指定其主目录。

如果计算机上没有所需的 JDK，请选择   下载 JDK  。 在下一个对话框中，指定 JDK 供应商、版本，必要时更改安装路径，然后点击   下载  。

![在项目结构对话框中显示可用的 SDK](https://resources.jetbrains.com.cn/help/img/idea/2026.3/sdks_project_structure_sdks.png)

Procedure: 移除 SDK

您可以从您的 IDE 中移除不必要的 SDK。

1. 在主菜单中，前往  `文件 | 项目结构 | 平台设置 | SDK` 。

2. 请选择要移除的 SDK，然后点击 !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.remove.svg)。

3. 应用更改并关闭对话框。

![从 IDE 中移除 SDK](https://resources.jetbrains.com.cn/help/img/idea/2026.3/remove_sdk.png)

Procedure: 添加项目 SDK

1. 在主菜单中，前往  `文件 | 项目结构 | 项目设置 | 项目` 。

2. 如果所需 SDK 已在 IntelliJ IDEA 中定义，请从   检测到的 SDK   列表中选择它。

3. 仅适用于 JDK：如果 IDE 无法自动在计算机上找到所需的 JDK，请点击   从磁盘添加 JDK  ，并在打开的对话框中指定其主目录。

如果计算机上没有所需的 JDK，请选择   下载 JDK  。 在下一个对话框中，指定 JDK 供应商、版本，必要时更改安装路径，然后点击   下载  。

![更改项目 SDK](https://resources.jetbrains.com.cn/help/img/idea/2026.3/sdks_project_structure_project.png)

Procedure: 添加模块 SDK

1. 在主菜单中，前往  `文件 | 项目结构 | 项目设置 | 模块` 。

2. 选择要为其设置 SDK 的模块，然后点击   依赖项  。

3. 如果所需 SDK 已在 IntelliJ IDEA 中定义，请从   检测到的 SDK   列表中选择它。

4. 仅适用于 JDK：如果 IDE 无法自动在计算机上找到所需的 JDK，请点击   从磁盘添加 JDK  ，并在打开的对话框中指定其主目录。

如果计算机上没有所需的 JDK，请选择   下载 JDK  。 在下一个对话框中，指定 JDK 供应商、版本，必要时更改安装路径，然后点击   下载  。

> **Tip:**
> 如果希望模块继承项目 SDK，请从   模块 SDK   列表中选择   项目SDK   选项。

![设置另一个模块级 SDK](https://resources.jetbrains.com.cn/help/img/idea/2026.3/sdks_project_structure_modules_dependencies.png)

## Java Development Kit (JDK)

要在 IntelliJ IDEA 中开发应用程序，您需要一个 Java SDK (JDK)。 JDK 是一个软件包，包含开发和测试 Java 应用程序的库、开发工具以及在 Java 平台上运行应用程序的工具（Java Runtime Environment – JRE）。

JRE 可以单独从 JDK 获取，但它不适合应用程序开发，因为它没有编译器和调试器等基本组件。

> **Note: 重要提示**
> * 捆绑的 JRE 被用于运行 IDE 本身，不足以开发 Java 应用。 在开始进行 Java 开发之前，请下载并安装一个 独立的 JDK 构建版本。
>
> * 由于 [Oracle Java 许可证的变更](https://java.com/en/download/release_notice.jsp)，您可能无权免费使用 Oracle 的 Java SE。 我们建议您使用其中一个 [OpenJDK builds](#openjdk-list) 以避免潜在的合规性失败。

在 IntelliJ IDEA 中，您可以 [直接从 IDE 下载 JDK 包](#jdk-from-ide)，或者手动下载必要的 JDK 发行版并在 IDE 中定义它。

要手动下载，请使用任意 [可用的发行版](https://en.wikipedia.org/wiki/OpenJDK#OpenJDK_builds)，例如：

* [Oracle OpenJDK](https://jdk.java.net/)

* [Adoptium](https://adoptium.net/)

* [Amazon Corretto](https://aws.amazon.com/corretto/)

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

Procedure: 设置项目 JDK

1. 在主菜单中，前往  `文件 | 项目结构 | 项目设置 | 项目` 。

2. 如果所需 JDK 已在 IntelliJ IDEA 中定义，请从   SDK   列表中选择它。

如果您的计算机上已安装 JDK 但在 IDE 中未定义，请选择   从磁盘添加 SDK  并指定 JDK 主目录的路径（例如，  `/Library/Java/JavaVirtualMachines/jdk-12.0.1.jdk` ）。

![更改项目 SDK](https://resources.jetbrains.com.cn/help/img/idea/2026.3/sdks_project_structure_project.png)

3. 如果计算机上没有所需的 JDK，请选择   下载 JDK  。 在下一个对话框中，指定 JDK 供应商、版本，必要时更改安装路径，然后点击   下载  。

![创建项目时下载 JDK](https://resources.jetbrains.com.cn/help/img/idea/2026.3/download-jdk.png)

4. 应用更改并关闭对话框。

> **Note:**
> 有关使用 JDK 的更多信息，请参阅 [在 Maven 项目中更改 JDK 版本](maven-support.html#change_jdk)和 [Gradle JVM 选择](gradle-jvm-selection.html)，如果您使用 Maven 或 Gradle 构建您的项目。

> **Tip:**
> IntelliJ IDEA 还通过  `JAVA_HOME`  和  `路径`  环境变量，在内置终端中提供项目 JDK，因此可以直接在此运行  `java` 、  `javac`  以及构建工具，无需额外配置。 有关更多信息，请参阅 [终端中的 JDK](terminal-emulator.html#terminal-jdk)。

### 使用版本管理器配置 JDK

当您在 IntelliJ IDEA 中使用诸如 [SDKMAN!](https://sdkman.io/) 或 [asdf](https://asdf-vm.com/) 等命令行工具来安装、管理并在不同 JDK 版本之间切换时，您可以使用内联提示，使版本管理更为便捷。

例如，如果您的  `.sdkmanrc`  或  `.tool-versions`  文件指定了尚未安装的 JDK 版本，将会出现一个内联提示，允许您直接下载。

![IntelliJ IDEA 中 .sdkmanrc 的内联提示](https://resources.jetbrains.com.cn/help/img/idea/2026.3/sdkman_download_jdk_inlay.png)

即使有 SDKMAN!，IntelliJ IDEA 也可以建议下载在项目  `.sdkmanrc`  文件中声明的 JDK！ 未安装。 当 IDE 内置 JDK 下载器可用匹配的 JDK 时，IntelliJ IDEA 会直接在 IDE 中提供安装，无需 SDKMAN!：请在嵌入提示菜单中选择   下载 JDK   选项下载 JDK。

如果所需的 JDK 版本已安装但尚未为项目配置，该提示将使您能够快速将其设置为项目 JDK。

![IntelliJ IDEA 中 .sdkmanrc 的内联提示](https://resources.jetbrains.com.cn/help/img/idea/2026.3/sdkman_set_project_jdk_inlay.png)

您可以在  `设置 | 编辑器 | 内联提示 | 代码视野 | Java 配置`  中找到此内联提示的设置。 在 [嵌入提示](inlay-hints.html) 中了解更多可用的内联提示及其使用方法。

Procedure: 禁用基于版本管理器文件的自动配置

当您打开使用版本管理器的项目时，IDE 会自动配置在相应配置文件中定义的 JDK（例如，  `.sdkmanrc`  或  `.tool-versions` ）。 您可以在设置中更改此行为。

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. 禁用选项   在项目打开时使用外部工具文件（如'.sdkmanrc'、'.tool-versions'等）配置 JDK   并应用更改。

## Kotlin SDK

Kotlin SDK 的分布式方式与 JDK 不同。 它作为常规库依赖项添加到您的项目中，并位于  `.m2` 文件夹中。 当 [创建新的 Kotlin 项目](get-started-with-kotlin.html#new-kotlin-project-no-frameworks)或同步现有项目时，IDE 会下载它。 您还可以 [将 Kotlin 添加到现有的 JVM 项目中](get-started-with-kotlin.html#add-kotlin-dependency)。

![项目工具窗口中的 Kotlin SDK](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kotlin_sdk.png)

通过 [Kotlin 文档](https://kotlinlang.org/docs/jvm-get-started.html)详细了解 Kotlin。

## See also

### Python 支持

[Configure Python SDK in IntelliJ IDEA](configuring-python-sdk.html)

### Ruby 支持

[Configure Ruby interpreter](configuring-language-interpreter.html)