JetBrains Rider 2019.2 Help

Using EditorConfig

JetBrains Rider supports code formatting styles, code syntax styles, and code inspection severity levels defined in the EditorConfig format.

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 ist 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:

root = true [*] # Most of the standard properties are supported indent_size=2 max_line_length=100 # Most frequently used .NET-coding-convention properties are supported csharp_space_between_parentheses=expressions, type_casts, control_flow_statements csharp_style_var_for_built_in_types=true # JetBrains Rider custom properties for code formatting styles resharper_csharp_brace_style=next_line resharper_csharp_blank_lines_around_invocable=2 # JetBrains Rider custom properties for code syntax styles csharp_default_private_modifier=explicit braces_for_ifelse=not_required# # JetBrains Rider custom properties for code inspections resharper_possible_null_reference_exception_highlighting=error resharper_replace_with_string_is_null_or_empty_highlighting=do not show

EditorConfig in your solution

By default, EditorConfig properties are enabled for code formatting styles and code syntax styles, and disabled for code inspection severity levels; 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 the Editor | Code Style page of JetBrains Rider settings.

To configure code inspections from EditorConfig, you have to select the Read settings from editorconfig, project settings and rule sets checkbox on the Editor | Inspection Settings 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:

    Code formatting options overridden by EditorConfig styles

Exporting 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 an .editorconfig file.

To export code style settings to EditorConfig

  1. Press Ctrl+Alt+S, or alternatively from the main menu, choose File | Settings on Windows and Linux or JetBrains Rider | Preferences on macOS, then choose Editor | Code Style on the left.

  2. In the EditorConfig section, click Export. This will open the .editorconfig dialog.

  3. By default, JetBrains Rider writes the settings to the .editorconfig file in the root directory of the current solution. If necessary, you can change the destination file using the path selector at the top of the dialog.

  4. In the Section (file mask) field, 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.

  5. For more detailed configuration, you can expand Show additional options and choose the following options:

    • Export settings that have default values
      By default, JetBrains Rider only saves properties for settings that you have changed. So only these settings will apply and override other settings when the resulting .editorconfig is read by ReSharper or Rider. All other settings will take values specified in the IDE.
      If you enable this option, JetBrains Rider will save all settings in their current state, regardless whether they were changed or not. This way you will get a stricter .editorconfig that will override all code style and formatting settings when read by ReSharper or Rider.

    • Remove existing properties with ambiguous values
      Some EditorConfig properties could correspond to multiple JetBrains Rider-specific properties, which allow for a more precise configuration. So there could be situations when a more general property agrees with some related JetBrains Rider-specific properties and contradicts to others, which makes this more general property ambiguous.
      As more detailed properties have higher priority, such a situation is not a problem and there is no need to remove properties with ambiguous values.
      The only case when you may want to remove properties with ambiguous values is when the project EditorConfig styles are going to be read only by ReSharper and Rider, and you want to remove redundancies from the .editorconfig file.

    • Export standard .editorconfig properties — whether to save standard .editorconfig properties These properties will also apply if the generated EditorConfig is read by other editors and IDEs.

    • Export cross-editor language-specific properties — whether to save .NET-coding-convention properties. These properties will also apply if the generated EditorConfig is read by other editors and IDEs.

    • Export JetBrains Rider/ReSharper-specific code style properties — whether to save product-specific code formatting styles, code syntax styles.

    • Export JetBrains Rider/ReSharper-specific inspection severities — whether to save severity levels for JetBrains Rider's configurable code inspections.

  6. 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 generate. Such properties will be shown in red, and if you proceed with exporting the conflicts will be resolved in favor of the newly generated ones.

  7. Click Export. JetBrains Rider will create or update the .editorconfig file in the specified location.

Disabling JetBrains Rider formatter with EditorConfig

In C#, C++, JavaScript, TypeScript, HTML, and Protobuf you can disable the JetBrains Rider formatter using EditorConfig masks that have disable_formatter=true.

Standard EditorConfig properties support note

JetBrains Rider will apply the following standard EditorConfig properties:

  • indent_size
  • indent_style
  • tab_width
  • max_line_length
  • insert_final_newline

.NET-coding-convention properties support note

As of version 2019.2, JetBrains Rider supports most frequently used EditorConfig properties for the .NET coding conventions:

  • The following properties for the formatting conventions:

    • csharp_new_line_before_open_brace
    • csharp_new_line_before_else
    • csharp_new_line_before_catch
    • csharp_new_line_before_finally
    • csharp_new_line_before_members_in_object_initializers
    • csharp_indent_switch_labels
    • csharp_space_after_cast
    • csharp_space_after_keywords_in_control_flow_statements
    • csharp_space_between_method_declaration_parameter_list_parentheses
    • csharp_space_between_method_call_parameter_list_parentheses
    • csharp_space_between_parentheses
    • csharp_preserve_single_line_blocks
  • The following properties for the language conventions:

    • dotnet_style_qualification_for_field
    • dotnet_style_qualification_for_property
    • dotnet_style_qualification_for_method
    • dotnet_style_qualification_for_event
    • dotnet_style_predefined_type_for_locals_parameters_members
    • dotnet_style_predefined_type_for_member_access
    • dotnet_style_require_accessibility_modifiers
    • csharp_preferred_modifier_order
    • csharp_style_var_for_built_in_types
    • csharp_style_var_when_type_is_apparent
    • csharp_style_var_elsewhere
    • csharp_style_expression_bodied_constructors
    • csharp_style_expression_bodied_methods
    • csharp_style_expression_bodied_properties
    • csharp_style_expression_bodied_accessors
    • csharp_prefer_braces
Last modified: 18 October 2019