Import a project from Eclipse

Launch IntelliJ IDEA.

If the Welcome screen opens, press CtrlShift0A, type project from existing sources, and click the Import project from existing sources action in the popup.

Otherwise, go to File | New | Project from Existing Sources in the main menu.

In the dialog that opens, select the directory in which your sources, libraries, and other assets are located and click Open.

Select Import project from external model | Eclipse and click Next.

note

If the project that you are importing uses a build tool, we recommend that you import it as a Maven or a Gradle project.

Configure the project:

• Select Eclipse projects directory: specify the path to the Eclipse workspace that contains projects that you want to import.

• Create module files near .classpath files: create a new IntelliJ IDEA module per each Eclipse project in the respective project directories. The IntelliJ IDEA project in the specified format will be created in the root of the Eclipse workspace, or Eclipse project directory.

• Keep project and module files in: if you want to import your project to IntelliJ IDEA without modifying the original Eclipse project, specify the folder in which the IDE will create the .iml file (module file) and the .idea directory with configuration files.

  If you leave the default path, IntelliJ IDEA creates the .iml file and .idea directory in the Eclipse project folder.

• Project file format: it's recommended that you use the directory-based format.

• Link created IntelliJ IDEA modules to Eclipse project files: automatically keep the Eclipse projects and IntelliJ IDEA modules synchronized.

• Detect test sources: specify the list of folders in which test sources are stored. For more information about the wildcard syntax, refer to the Compiler.

Click Next.

Review the projects detected in the selected Eclipse workspace and select the ones that you want to import to IntelliJ IDEA. Each Eclipse project will be converted into an IntelliJ IDEA module.

Click Next.

Select the code style configuration that you want to use in the project and click Next.

Specify the SDK that you want to use.

If the necessary SDK is already defined in IntelliJ IDEA, select it from the list on the left. Otherwise, click and add a new SDK.

Click Create.

In the main menu, go to File | New | Module from Existing Sources.

In the dialog that opens, select the directory in which your sources, libraries, and other assets are located and click Open.

Select Import module from external model | Eclipse and click Next.

note

If the project that you are importing uses a build tool, we recommend that you import it as a Maven or a Gradle module.

Configure the module:

• Select Eclipse projects directory: specify the path to the Eclipse workspace that contains projects that you want to import.

• Create module files near .classpath files: create a new IntelliJ IDEA module per each Eclipse project the respective project directories. The IntelliJ IDEA project in the specified format will be created in the root of the Eclipse workspace, or Eclipse project directory.

• Keep project and module files in: if you want to import your project to IntelliJ IDEA without modifying the original Eclipse project, specify the folder in which the IDE will create the .iml file (module file) and the .idea directory with configuration files.

  If you leave the default path, IntelliJ IDEA creates the .iml file and .idea directory in the Eclipse project folder.

• Link created IntelliJ IDEA modules to Eclipse project files: automatically keep the Eclipse projects and IntelliJ IDEA modules synchronized.

• Detect test sources: specify the list of folders in which test sources are stored. For more information about the wildcard syntax, refer to the Compiler section.

Click Next.

Review the projects detected in the selected Eclipse workspace and select the ones that you want to import to IntelliJ IDEA. Each Eclipse project will be converted into an IntelliJ IDEA module.

Click Next.

Select the code style configuration that you want to use in the project and click Next.

Click Create.

The project will appear in the Project tool window as a module.