What is EditorConfig and how does JetBrains Rider extend it?
EditorConfig is a configuration file convention that is used to define and maintain consistent code styles between team members working on the same code as well as between different editors and IDEs that they might use. The styles are saved in INI-like files named .editorconfig, where section names are file masks and properties inside a section define code styles for files matching that masks.
As EditorConfig convention suggests, JetBrains Rider will apply code styles defined in files named .editorconfig in the directory of the current file and in all its parent directories until it reaches the root filepath or finds an EditorConfig file with
root=true. File masks specified in .editorconfig files, for example
*Test.cs are also taken into account.
JetBrains Rider understands standard EditorConfig properties, most frequently used .NET-coding-convention EditorConfig properties, and provides a set of custom EditorConfig properties, which allow for much more granular configuration of formatting, syntax, and code inspection rules — in fact, each code style preference that you can configure in the JetBrains Rider settings dialog has its own EditorConfig property. This means that you can maintain the entire configuration of code style and inspection rules in EditorConfig files . Below is an example of EditorConfig properties supported by JetBrains Rider:
EditorConfig in your solution
By default, JetBrains Rider takes into account EditorConfig properties and they will override preferences defined in JetBrains Rider settings . If you want JetBrains Rider to ignore EditorConfig styles for code formatting and code syntax , clear the corresponding checkbox on thepage of JetBrains Rider settings .
To configure code inspections and naming styles from EditorConfig, you have to select the Read settings from editorconfig, project settings and rule sets checkbox on the page of JetBrains Rider settings .
When EditorConfig support is enabled and there are .editorconfig files that affect the current file, JetBrains Rider will help you understand which EditorConfig styles are applied and where these settings come from:
On JetBrains Rider code style and formatting options pages , you will see a yellow warning if at least one preference on the page is overridden by EditorConfig styles for the current file, each overridden preference will also be highlighted with yellow. For example:
In the Code Style Configuration dialog, you can see and study all .editorconfig files that affect the current file:
Export code style settings to EditorConfig
If you are going to share code style settings via EditorConfig, you may want to export the styles already configured in JetBrains Rider to the .editorconfig file.
Press Control+Alt+S or choose(Windows and Linux) or (macOS) from the menu , then choose on the left.
Click Export next to Enable EditorConfig support. This will open the Export to .editorconfig dialog.
By default, JetBrains Rider writes the settings to a new .editorconfig file in the root directory of the current solution. If one or more .editorconfig files exist, JetBrains Rider will use the closest file in the directory hierarchy to save the settings. If necessary, you can change the destination file using the path selector at the top of the dialog.
In the Section (file mask) field, you can specify a wildcard pattern to use for the section with generated properties. Note that if you choose to export standard EditorConfig properties, they will be placed in other sections according to language conventions.
If there is an existing .editorconfig file in the specified location, there could be conflicts between values of properties that exist there and the ones that JetBrains Rider is about to save. Such properties will be shown in red and if you proceed with saving, the conflicts will be resolved in favor of the newly generated ones.
Click Export. JetBrains Rider will create or update the .editorconfig file in the specified location.
You can also save formatting styles to EditorConfig after contextual configuration of formatting rules.
Disable JetBrains Rider formatter with EditorConfig
In C#, you can disable the JetBrains Rider formatter using EditorConfig masks that have
Standard EditorConfig properties
JetBrains Rider will apply the following standard EditorConfig properties:
Note that among JetBrains Rider's custom EditorConfig properties, there are properties that will override the standard properties for specific languages. For example, you can set a default indent size for all languages with
indent_size property, and at the same set a different indent size for C# files with csharp_indent_size property.
Custom EditorConfig properties
Custom EditorConfig properties that JetBrains Rider provides, allow configuring code style and code inspection settings. Properties for code inspections can be found in the Code Inspections in C#. Properties for code style and formatting settings are listed in the child pages of the EditorConfig properties by language and category topic.
.NET-coding-convention EditorConfig properties
As of version 2023.2, JetBrains Rider supports most frequently used EditorConfig properties for the .NET coding conventions:
dotnet_diagnostic.*— supported for all compiler warnings.
dotnet_naming_symbols.*— will work if the specified kinds of symbols can be matched by kinds of symbols available in JetBrains Rider naming settings.