IntelliJ IDEA 2018.1 Help

Refactoring Source Code

Refactoring is a process of improving your source code without creating a new functionality. Refactoring helps you keep your code solid, dry, and easy to maintain.

Invoke refactoring

  1. Select an item to refactor. You can select a file/folder in the Project tool window or expression/symbol in the editor.
  2. Press Ctrl+Shift+Alt+T to open a pop-up list of refactorings that can be selected.
    refactoring invoke
    Alternatively, you can press a shortcut for a specific refactoring.
  3. If you need to undo your refactoring, press Ctrl+Z.

Preview refactoring changes

For some refactorings IntelliJ IDEA provides an option to preview the changes before applying them.

  1. To see the potential changes and make the necessary adjustments, click Preview in the refactoring-specific dialog.
    specific refactor dialog
  2. Check the changes that are going to be made in the Find tool window.
    refactoring preview
  3. Click Do Refactor (Alt+D) to proceed with the changes.

Resolve conflicts

When IntelliJ IDEA encounters problems with your refactoring, it opens a dialog with the list of conflicts and their brief descriptions.

refactoring confilicts dialog
  • Click Continue to ignore the problem and proceed to open the preview in the Find tool window.
  • Click Show Conflicts in View to open the conflict entries in the Find tool window and deal with them further.

    For example, you can try to exclude an entry from refactoring by pressing Delete or click Cancel and return to the editor.

    refactoring conflicts tool window

Configure refactoring settings

To configure refactoring settings:

  1. Press Ctrl+Alt+S and from the options on the right, select Editor | General.
  2. On the General page, in the Refactorings section, adjust the refactoring options and click OK.

To see and adjust refactoring intentions:

  1. Press Ctrl+Alt+S and from the options on the right, select Editor | Intentions.
  2. From the options on the right, in a search field start typing "refactoring" to quickly locate the refactoring items. Adjust the settings and click OK.

The most popular refactorings supported in IntelliJ IDEA

Safe Delete Alt+DeleteMakes sure that you do not delete files that are referenced in your source code. Safe Delete
Copy/MoveF5/F6Copies/Moves an element.Move and Copy refactorings
Extract MethodCtrl+Alt+MThese refactoring actions help you reduce the code duplication.Extract method
Extract ConstantCtrl+Alt+CExtract Constant
Extract FieldCtrl+Alt+FExtract Field
Extract ParameterCtrl+Alt+PExtract parameter
Extract Variable Ctrl+Alt+V Extract Variable
Rename Shift+F6 Renames an element.Rename Refactorings
InlineCtrl+Alt+NInlines an element. Acts as opposite of extracting.Inline
Change signatureCtrl+F6Changes the call signature of method or class.Change Signature
Last modified: 24 July 2018

See Also