# 导入项目

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

在 IntelliJ IDEA 中，您可以通过几种方式开始使用现有代码。 您可以打开之前创建的 IntelliJ IDEA 项目，从源代码创建一个新项目，或者从外部模型导入一个项目。

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

## 打开项目（简单导入）

此选项将所选项目按原样导入到 IntelliJ IDEA 中（打开它）。 如果您希望在导入项目时设置自定义设置（例如，选择另一个 SDK 或选择要导入的库），请参考 [从现有源创建项目](#create-from-sources)。

Procedure:

1. 启动 IntelliJ IDEA。

在 IntelliJ IDEA 主屏幕上，点击   打开  。 如果已经打开了一个项目，请在主菜单中转到  `文件 | 打开` 。

2. 在打开的对话框中，选择包含源代码、库和其他资源的目录，然后点击   打开  。

3. 首次导入或克隆项目时，IntelliJ IDEA 会对其进行分析。 如果 IDE 检测到多个配置（例如，Eclipse 和 Gradle），它会提示您选择要使用的配置。

> **Note:**
> 如果要导入的项目使用构建工具，例如 [Maven](maven-support.html) 或 [Gradle](gradle.html)，建议选择构建工具配置。

选择所需的配置并点击   OK  。

IDE 将根据您的选择对项目进行预配置。 例如，如果选择   Gradle  ，IntelliJ IDEA 将执行其构建脚本、加载依赖项等。

4. 如果之前正在处理另一个项目，请选择是在新对话框中打开新项目，还是在当前对话框中打开。

> **Tip:**
> 有关从版本控制中获取项目的更多信息，请参阅 [从远程主机检出项目（git clone）](set-up-a-git-repository.html#clone-repo)。

## 导入带有设置的项目

> **Note:**
> 本节介绍开箱即用的功能。 如果您使用框架插件，请参阅相应的文档部分。

Procedure: 从外部模型导入项目

如果您的项目来自外部模型，并且您希望整体导入它，请使用此类型的导入。 在这种情况下，IntelliJ IDEA 会解释项目文件（例如，您的 Eclipse 项目将迁移到 IntelliJ IDEA）。

1. 启动 IntelliJ IDEA。

在 IntelliJ IDEA 主屏幕上，按 `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS))，输入  `project from existing sources` ，然后点击   从现有源代码导入项目  。

如果已经打开了一个项目，请在主菜单中转到  `文件 | 新建 | 从现有源创建项目…` 。

2. 在打开的对话框中，选择包含源代码、库和其他资源的目录，然后点击   打开  。

3. 请选择   从外部模型导入项目  并选择您的项目所使用的模型：

Eclipse:

选择 [Eclipse](import-project-from-eclipse-page-1.html#step3)并点击   下一步  。

![从外部模型导入项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/import-from-model.png)

Maven:

选择 [Maven](maven-support.html#maven_import_project_start) 并点击   创建  。

对于 Maven 项目，IDE 会自动配置设置。 项目导入后，您可以进行调整。

![从外部模型导入项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/import-from-model-maven.png)

Gradle:

选择 [Gradle](gradle.html#gradle_import_project_start) 并点击   创建  。

对于 Gradle 项目，IDE 会自动配置这些设置。 项目导入后，您可以进行调整。

![从外部模型导入项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/import-from-model-gradle.png)

Procedure: 从现有源创建项目

使用此类导入来创建 一个 IntelliJ IDEA 项目，该项目基于现有的源代码，而不一定是导出的项目。

1. 启动 IntelliJ IDEA。

在 IntelliJ IDEA 主屏幕上，按 `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS))，输入  `project from existing sources` ，然后点击   从现有源代码导入项目  。

如果已经打开了一个项目，请在主菜单中转到  `文件 | 新建 | 从现有源创建项目…` 。

2. 在打开的对话框中，选择包含源代码、库和其他资源的目录，然后点击   打开  。

3. 请选择   从现有源代码创建项目   选项并点击   下一步  。

![从现有源创建项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/import-from-sources.png)

4. 指定新项目的名称和位置，并选择一个格式。 建议您使用 [directory-based format](creating-and-managing-projects.html#project-formats)。

点击   下一步  。

如果您将项目导入同一目录，IDE 会询问您是否要覆盖它。 如果您点击   是  ，IntelliJ IDEA将会覆盖  `.idea` 目录中的文件和  `.iml` 文件，您的源文件将保持不变。

![一个弹出窗口警告您该文件夹将被覆盖](https://resources.jetbrains.com.cn/help/img/idea/2026.3/not-empty-folder.png)

5. 选择您要用作源根目录的目录（存放源代码的文件夹），然后点击   下一步  。

![导入源](https://resources.jetbrains.com.cn/help/img/idea/2026.3/import-sources.png)

6. 选择要添加到新项目中的库。

您可以通过点击 ![合并按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.vcs.merge.svg)将多个选定的库或存档合并为一个新库，也可以通过点击 ![拆分按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.actions.split.svg)将选定的库拆分为两个。

点击   下一步

![导入库](https://resources.jetbrains.com.cn/help/img/idea/2026.3/import-lib.png)

7. 审核模块结构：选择您想要包含在项目中的模块。

您可以通过点击 ![合并按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.vcs.merge.svg) 将多个模块合并为一个，或通过点击 ![拆分按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.actions.split.svg) 将选定的模块分成两个。

点击   下一步

![导入模块](https://resources.jetbrains.com.cn/help/img/idea/2026.3/import-project-modules.png)

8. 指定要使用的 [SDK](sdk.html)。

如果所需 SDK 已在 IntelliJ IDEA 中定义，请从左侧列表中选择它。 否则，请点击 !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)并添加一个新的 SDK。

点击   下一步  。

![导入 SDK](https://resources.jetbrains.com.cn/help/img/idea/2026.3/import-sdk.png)

9. 启用对检测到的框架和技术的支持：选择必要项目旁边的复选框。

您还可以指定文件指示器的分组方式：按类型（按框架）或按目录（按位置）。

10. 点击   创建  。

## See also

### 过程

[Maven 项目](delegate-build-and-run-actions-to-maven.html) [Gradle 项目](work-with-gradle-projects.html)

