Refactoring in Visual Studio for Mac

Important

Visual Studio for Mac is scheduled for retirement on August 31, 2024 in accordance with Microsoft’s Modern Lifecycle Policy. While you can continue to work with Visual Studio for Mac, there are several other options for developers on Mac such as the preview version of the new C# Dev Kit extension for VS Code.

Learn more about support timelines and alternatives.

Refactoring code is a way to rearrange, restructure, and clarify existing code while ensuring that the overall behavior of the code doesn't change.

Refactoring produces a healthier code base, making it more useable, readable, and maintainable for you or any other developer or user that might refer to the code.

Visual Studio for Mac's integration with Roslyn, Microsoft's open-source .NET compiler platform, allows for more refactoring operations.

Renaming

The Rename refactoring command can be used on any code identifier (for example, a class name, property name etc.) to find all occurrences of that identifier and change them. To rename a symbol, right-click on it and choose Rename..., or use the Cmd (⌘) + R key binding:

Rename menu item

This highlights the symbol and any references to it. When you start typing a new name it automatically changes all references in your code, and you can commit your changes by pressing Enter:

Renaming and identifier

Quick Actions and Refactorings

Quick Actions and Refactorings let you easily refactor, generate, or otherwise modify code with a single action.

Quick Actions can be used to:

  • Apply a code fix for a code analyzer rule violation
  • Suppress a code analyzer rule violation
  • Apply a refactoring (for example, inline a temporary variable)
  • Generate code (for example, introduce a local variable)

Quick Actions can be applied by using the light bulb light bulb icon or screwdriver screwdriver icon icons, or by pressing Option (⌥)+Enter when your cursor is on a line of code for which an action is available. You'll see an error light bulb error light bulb icon if there is a red squiggle indicating an error, and Visual Studio has a fix available for that error.

For any language, third parties can provide custom diagnostics and suggestions, for example as part of an SDK, and Visual Studio light bulbs light up based on those rules.

Quick Action Icons

The icon that appears when a Quick Action is available gives an indication of the type of fix or refactoring that's available. The screwdriver screwdriver icon icon indicates just that there are actions available to change the code, but you shouldn't necessarily use them. The yellow light bulb light bulb icon icon indicates there are actions available that you should do to improve your code. The error light bulb error light bulb icon icon indicates there's an action available that fixes an error in your code.

To see a light bulb or screwdriver

  • If a fix is available, light bulbs spontaneously appear when you hover the mouse at the location of an error.

    Light bulb with mouse hovering

  • Light bulbs and screwdrivers appear in the left margin of the editor when you move the caret into a line of code for which a Quick Action or Refactoring is available.

  • Press Option (⌥)+Enter anywhere on a line to see a list of available Quick Actions and refactorings.

Display Context Items

Hovering over any of the context actions provides you with a preview of what will be added or removed from your code.

Option Enter Context items

To enable these options, you must select Enable source analysis of open files in the options Visual Studio for Mac > Preferences > Text Editor > Source Analysis:

Enabling Source analysis

There are over 100 possible actions that can be suggested, which are enabled or disabled by browsing to Visual Studio for Mac > Preferences > Source Analysis > C# > Code Actions and selecting or unselecting the box next to the action:

C# Source Analysis actions

Common quick actions

You can learn more about common quick actions in the Common Quick Actions article.

Source analysis

Source analysis analyzes your code on the fly by underlining potential errors and style violations, and providing auto fixes as context actions.

You can view all results of the source analysis for any file, at any time, by viewing the scroll bar on the right side of the text editor:

Source Analysis sidebar

If you click on the circle at the top, you can iterate through each suggestion, with the highest severity issues showing first. Hovering over an individual result or line displays the issue, which can be fixed through context actions:

Source Analysis Item

See also