General Formatter Style
ReSharper's formatting options are configurable in a very flexible way and for each supported language separately. While this page provides a few general settings, the language-specific pages () allow you to fine-tune code formatting according to your coding standards and practices.
The options that you configure on this page apply in the following cases:
- When code is automatically formatted on editing or after pasting (you can toggle auto-formatting on the page of ReSharper options.
- When ReSharper produces new code with code completion and code generation features, applies code templates and performs refactorings.
- When you reformat existing code.
|Auto-detect indent size and style|| |
When you reformat a part of code in a file or when code is auto-formatted on editing or pasting, ReSharper can calculate and apply indentation based on the existing indents in that file.
You can also toggle the auto-detecting indents preference and view its status in the File Formatting Info window.
Note that ReSharper will NOT auto-detect indents if you reformat the whole file or multiple files, or if there are .editorconfig files that affect the current file.
Note also, that if you enable auto-detecting indents, or indents in ReSharper settings, or if you have .editorconfig files that affect the current file, then indents from these sources are temporary saved in Visual Studio settings while the affected file is open and active in Visual Studio.
|Default line ending style|| ReSharper allows you to use custom line endings in your code, and you can use this selector to choose which line ending style should be used. |
If you tick the Enforce line ending style on full reformat checkbox, ReSharper will apply the selected line ending style when you reformat code or run code cleanup on a file, project, or solution as well as when new files are created with ReSharper features (e.g. file templates or refactorings).
|Code style configuration files|
|Enable EditorConfig support|| |
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.Use this check box to make ReSharper respect code formatting styles defined in EditorConfig configuration files. For more information, see Using EditorConfig.
|Enable Clang-Format styles support|| Clang-Format is a widely-used C++ code formatter. As it provides an option to define code style options in YAML-formatted files — named .clang-format or _clang-format — these files often become a part of your project where you keep all code style rules. |
Use this check box to make ReSharper respect code formatting styles defined in Clang-Format configuration files. For more information, see Using Clang-Format.
|Enable StyleCop support|| |
When StyleCop integration is enabled, settings from settings.stylecop files will override ReSharper code formatting and code syntax styles, and enable corresponding code inspections.
If you use EditorConfig and StyleCop configuration files simultaneously, the EditorConfig settings will always take precedence over both StyleCop and ReSharper settings. This means that if settings from settings.stylecop do not give desired results for some reason, you can always override specific settings using EditorConfig properties.By default, ReSharper does not read settings from settings.stylecop files. To start taking these settings into account, enable Enable StyleCop support on the page of ReSharper options in addition to this checkbox.
|Provide ReSharper indent settings to Visual Studio|| If this option is enabled, ReSharper will provide indenting preferences (both from its layer-based settings and from supported configuration files) to Visual Studio, so that they are used when the code is created or transformed using Visual Studio features. |
This option is disabled by default because ReSharper overrides almost all Visual Studio's coding assistance features with its own features.
|Show indicator in status bar when EditorConfig is present||If this option is enabled, ReSharper displays the icon in the bottom right part of the Visual Studio window if there are any code style configuration files that apply to the current solution. You can double-click this icon to study active EditorConfig configurations in the File Formatting Info window.|