# 从 Eclipse 导入项目

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

## 导入项目到 IntelliJ IDEA

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. 如果之前正在处理另一个项目，请选择是在新对话框中打开新项目，还是在当前对话框中打开。

## 导入带有设置的项目

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

Procedure:

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` ，然后点击   下一步  。

> **Note:**
> 如果您正在导入的项目使用了构建工具，建议您将其作为 [Maven](maven-support.html) 或 [Gradle](gradle.html) 项目导入。

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

4. 配置项目：

* 选择 Eclipse 项目目录 ：指定包含要导入的项目的 Eclipse 工作区的路径。

* 在类路径文件附近创建模块文件 ：请在各个 Eclipse 项目目录中为每个项目创建一个新的 IntelliJ IDEA 模块。 将在 Eclipse 工作区根目录或 Eclipse 项目目录中创建采用指定格式的 IntelliJ IDEA 项目。

* 将项目和模块文件保存在此处。 ：如果希望在不修改原始 Eclipse 项目的情况下将项目导入 IntelliJ IDEA，请指定 IDE 将在其中创建 `.iml` 文件（ 模块文件 ）和包含配置文件的 `.idea` 目录的文件夹。 如果保留默认路径，IntelliJ IDEA 会在 Eclipse 项目文件夹中创建 `.iml` 文件和 `.idea` 目录。

* 项目文件格式 ：建议您使用 [基于目录的格式](creating-and-managing-projects.html#project-formats)。

* 将已创建的 IntelliJ IDEA 模块链接到 Eclipse 项目文件 ：自动保持 Eclipse 项目和 IntelliJ IDEA 模块同步。

* 检测测试源 ：指定存储测试源的文件夹列表。 有关通配符语法的更多信息，请参阅 [编译器](compiler.html)。

点击   下一步  。

![从 Eclipse 导入项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/import-from-eclispe-project.png)

5. 查看在所选 Eclipse 工作区中检测到的项目，并选择要导入到 IntelliJ IDEA 的项目。 每个 Eclipse 项目都将被转换为 一个 IntelliJ IDEA 模块。

点击   下一步  。

![从 Eclipse 导入项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/import-from-eclipse-files.png)

6. 选择要在项目中使用的代码样式配置，然后点击   下一步  。

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

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

8. 点击   创建  。

> **Note:**
> 根据项目配置，向导可能会包含其他步骤。 例如，可能会提示选择项目代码样式或用户库。

## 将 Eclipse 项目作为模块导入

Procedure:

1. 在主菜单中，前往  `文件 | 新建 | 从现有源创建模块…` 。

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

3. 选择  `从外部模型导入模块 | Eclipse` ，然后点击   下一步  。

> **Note:**
> 如果您正在导入的项目使用构建工具，我们建议您将其作为 [Maven](maven-support.html) 或 [Gradle](gradle.html) 模块导入。

![从 Eclipse 导入项目作为模块](https://resources.jetbrains.com.cn/help/img/idea/2026.3/import-eclipse-module.png)

4. 配置模块：

* 选择 Eclipse 项目目录 ：指定包含要导入的项目的 Eclipse 工作区的路径。

* 在类路径文件附近创建模块文件 ：为每个 Eclipse 项目的各个项目目录创建一个新的 IntelliJ IDEA 模块。 将在 Eclipse 工作区根目录或 Eclipse 项目目录中创建采用指定格式的 IntelliJ IDEA 项目。

* 将项目和模块文件保存在此处。 ：如果希望在不修改原始 Eclipse 项目的情况下将项目导入 IntelliJ IDEA，请指定 IDE 将在其中创建 `.iml` 文件（ 模块文件 ）和包含配置文件的 `.idea` 目录的文件夹。 如果保留默认路径，IntelliJ IDEA 会在 Eclipse 项目文件夹中创建 `.iml` 文件和 `.idea` 目录。

* 将已创建的 IntelliJ IDEA 模块链接到 Eclipse 项目文件 ：自动保持 Eclipse 项目和 IntelliJ IDEA 模块同步。

* 检测测试源 ：指定存储测试源的文件夹列表。 有关通配符语法的更多信息，请参阅 [编译器](compiler.html)部分。

点击   下一步  。

![从 Eclipse 导入项目作为模块](https://resources.jetbrains.com.cn/help/img/idea/2026.3/configure-eclipse-module.png)

5. 查看在所选 Eclipse 工作区中检测到的项目，并选择要导入到 IntelliJ IDEA 的项目。 每个 Eclipse 项目都将被转换为 一个 IntelliJ IDEA 模块。

点击   下一步  。

![从 Eclipse 导入项目作为模块](https://resources.jetbrains.com.cn/help/img/idea/2026.3/import-module-from-eclipse-files.png)

6. 选择要在项目中使用的代码样式配置，然后点击   下一步  。

7. 点击   创建  。

项目将在   项目   工具窗口中以模块形式出现。

> **Note:**
> 根据项目配置，向导可能会包含其他步骤。 例如，可能会提示选择项目代码样式或用户库。

有关 IntelliJ IDEA 中模块的更多信息，请参阅 [模块](creating-and-managing-modules.html)。

## See also

### 过程

[将 Eclipse 项目导入 IntelliJ IDEA](migrating-from-eclipse-to-intellij-idea.html#migratingEclipseProject) [用户界面差异](migrating-from-eclipse-to-intellij-idea.html#user_interface) [Maven](maven-support.html) [Gradle](gradle.html)

### 参考

[项目工具窗口](project-tool-window.html)

