Auto import

You can configure the IDE to automatically add import statements if there are no options to choose from.

1. Press to open settings and then select Editor | General | Auto Import.

2. Select the Add unambiguous imports on the fly checkbox, and apply the changes.

   When you are pasting blocks of code that contain references to classes or static methods and fields that are not yet imported, the IDE automatically inserts the missing import statements. If you want to change that, from the Insert imports on paste list, select Ask to confirm every insertion or Never to insert import statements manually.

   

IntelliJ IDEA suggests importing single classes by default. You can change the settings to import entire packages instead.

1. Press to open settings and then select Editor | Code Style | Java | Imports.

2. Clear the Use single class import checkbox, and apply the changes.

• Hover over the inspection widget in the top-right corner of the editor, click , and disable the Show Auto-Import Tooltip option.

1. Press to open settings and then select Editor | General | Auto Import.

2. Make sure the necessary options are selected for the Show auto-import tooltip for setting (both checkboxes, Classes and Static methods and fields, are enabled by default).

1. Press to open settings and then select Editor | Code Style | Java.

2. Make sure that the Use single class import option is enabled.

3. In the Class count to use import with '*' and Names count to use static import with '*' fields, specify values that definitely exceed the number of classes in a package and the number of names in a class (for example, 999).

To replace an import statement with single class imports in a file without changing the settings, place the caret at the import statement, press (or use the intention action icon), and select Replace with single class imports.

1. Press to open settings and then select Editor | General | Auto Import.

2. In the Exclude from auto-import and completion section, click , and specify a class or a package that you want to exclude.

   You can also select whether you want to exclude items from the current project or from all projects (globally).

1. Press on a missing class to open the list of import suggestions.

2. Click the right arrow next to a package and select an item (a class or an entire package) that you want to exclude.

3. In the Exclude from auto-import and completion section of the Auto Import dialog, select whether you want to exclude items from the current project or from all projects, and apply the changes.

1. Select a file or a directory in the Project tool window (View | Tool Windows | Project).

2. Do any of the following:

   • In the main menu, go to Code | Optimize Imports (or press ).

   • From the context menu, select Optimize Imports.

3. (If you've selected a directory) Choose whether you want to optimize imports in all files in the directory, or only in locally modified files (if your project is under version control), and click Run.

1. Place the caret at the unused import statement and press or use the icon.

   Unused statements are greyed out by default.

2. From the list of suggestions, select Remove unused imports.

   

If your project is under version control, you can configure IntelliJ IDEA to optimize imports in modified files before committing them to VCS.

note

This feature is only available for Git and Mercurial.

1. Press to open the Commit tool window and click Show Commit Options .

2. Click and in the commit message area, select the Optimize imports checkbox.

   

You can configure the IDE to optimize imports in modified files automatically when your changes are saved.

1. Press to open settings and then select Tools | Actions on Save.

2. Enable the Optimize imports option.

   Additionally, from the All file types list, select the types of files in which you want to optimize imports.

3. Apply the changes and close the dialog.

You can tell IntelliJ IDEA to optimize imports in a file every time it is reformatted.

• Open the file in the editor, press , and make sure the Optimize imports checkbox is selected in the Reformat File dialog that opens.

  

After that every time you press in this project, IntelliJ IDEA will optimize its imports automatically.

note

When you create a class from a template with the Optimize imports on the fly option enabled, IntelliJ IDEA will optimize imports from this template only after you reopen the project.

You can also configure the IDE to automatically optimize imports. IntelliJ IDEA will remove or modify import statements according to the rules specified in Settings | Editor | Code Style | <language> | Imports as you work in the editor.

1. Press to open settings and then select Editor | General | Auto Import.

2. Enable the Optimize imports on the fly option and apply the changes.