I'd like to selectively disable the IntelliJ IDEA code formatter for a portion of code just like I can in Eclipse. Does IntelliJ support this feature, and if so, how do I use it?
-
1Official Documentation for skipping some part of the code using comments: jetbrains.com/help/idea/… – Mayank Patel Jul 1 '17 at 7:15
Since version 13 it's possible to wrap the code with
// @formatter:off
...
// @formatter:on
IntelliJ IDEA v.2018+:
File > Settings > Editor > Code Style
IntelliJ IDEA v.2016+:
Preferences > Editor > Code Style
IntelliJ IDEA v.14+:
Preferences > Editor > Code Style > Formatter Control
You can change the formatter control markers, as long as they're in comments.
Ensure formatter markers in comments are enabled, as shown in the following figure:
-
1Currently,
@formatter:on
(or whatever you define) does nothing unless@formatter:off
was already present. There are likely other ways of turning off reformatting -- or getting the editor to not reformat your code automatically. Search your preferences. This setting is to control sections that shouldn't be reformatted when manually performing a "Reformat", for instance. – Louis St-Amour Jul 14 '14 at 19:29 -
89You must go to
Preferences
->Code Style
->General
->Formatter Control
and checkEnable formatter markers in comments
for this to work. – Heath Borders Aug 27 '14 at 21:06 -
14In 14, this is in Preferences > Editor > Code Style > Formatter Control – Emerson Farrugia May 23 '15 at 19:29
-
3
-
10Why does this option disabled by default? It seems very useful to put markers in the code and restrict formatting for the whole team. – Timur Yarosh May 18 '17 at 11:03
Note for Carlos' answer of @formatter:off
and @formatter:on
to work, you may need to enable the preference first:
Discovered via How to config intellij-idea not format some part of the code?
IDEA-56995 Disabled code formatting per region using comments
-
7
-
4Search preferences for "Reformat" to see checkboxes for quite a few of the ways IntelliJ reformats code automatically: on paste, on typing a closing brace, from templates... You can really dig in if you want to change the functionality. Not that it always makes sense. Use IntelliJ's support if asking a question, or their bug tracker if making a suggestion. – Louis St-Amour Jul 14 '14 at 19:23
-
1It's equally possible that enabling regular expressions, then using
.
as your formatter off instruction might work. So long as the first line in your file can be reformatted. No guarantees though. :) – Louis St-Amour Jul 14 '14 at 19:25
In xml files use:
<!-- @formatter:off -->
<!-- @formatter:on -->
-
2Doesn't work in xml files. Android Studio 3.4.1 based on Intelli-J. – Vito Valov Jun 12 '19 at 11:30
-
It doesn't work in IntelliJ IntelliJ IDEA 2020.1.2 unless you enable then, in “File/Settings/Editor/Code Style“, in “Formatter Control” section. – Tony Falabella Jun 12 '20 at 10:45
Obsolete answer from 2010:
No, it's not possible right now, I've submitted a new issue which you can track.
As a temporary solution you can use external formatter plug-in for IDEA which can utilize Eclipse code formatter (I didn't check whether this particular option is supported).
It's currently not possible to exclude entire files (like regression test data xmls) from formatting. See https://youtrack.jetbrains.com/issue/IDEA-167112
https://www.gamefromscratch.com/post/2015/02/01/Preventing-IntelliJ-code-auto-formatting-from-ruining-your-day.aspx edit it in code style you can anything to control unformat snippet