RuboCop installs statistics

vscode-rubocop

This is the official VS Code extension for RuboCop.

You can install this VS Code extension from the Visual Studio Marketplace.

For VS Code-based IDEs like VSCodium or Eclipse Theia, the extension can be installed from the Open VSX Registry.

Language Server Capabilities

These are the capabilities of this extension, each enabled by RuboCop's built-in LSP server.

It supports the following capabilities:

• Fast Diagnostics (Linting) • Fast Document Formatting • Execute Command (Trigger autocorrect)

:star2: Pro tip: Enabling Format On Save is recommended. By activating just this one setting, code gets autocorrected every time a file is saved. Don't miss out on this game-changing boost to your development experience!

Requirements

• RuboCop 1.53.0+ • VS Code 1.75.0+

Configuration

The extension only offers a few of its own configuration options, but because it conforms to the VS Code Formatting API, several general editor settings can impact the extension's behavior as well.

Configuring the VS Code editor to use RuboCop

There are two general editor settings that you'll want to verify are set in order to use RuboCop as your formatter.

editor.formatOnSave

To automatically format your Ruby with RuboCop, check Format on Save in the Formatting settings under Text Editor:

Or, in settings.json:

editor.defaultFormatter

Next, if you have installed multiple extensions that provide formatting for Ruby files (it's okay if you're not sure—it can be hard to tell), you can specify RuboCop as your formatter of choice by setting editor.defaultFormatter under a "[ruby]" section of settings.json like this:

Configuring RuboCop extension options

To edit RuboCop's own options, first expand Extensions and select RuboCop from the sidebar of the Settings editor.

rubocop.mode

The Mode setting determines how (and whether) RuboCop runs in a given workspace. Generally, it will try to execute rubocop via bundle exec if possible, and fall back on searching for a global rubocop bin in your PATH.

• _"Always run—whether via Bundler or globally"_ (JSON: enableUnconditionally) this mode will first attempt to run via Bundler, but if that fails for any reason, it will attempt to run rubocop in your PATH • [Default] _"Run unless the bundle excludes rubocop"_ (JSON: enableViaGemfileOrMissingGemfile) this mode will attempt to run RuboCop via Bundler, but if a bundle exists and the rubocop gem isn't in it (i.e. you're working in a project doesn't use RuboCop), the extension will disable itself. If, however, no bundle is present in the workspace, it will fall back on the first rubocop executable in your PATH • _"Run only via Bundler, never globally"_ (JSON: enableViaGemfile) the same as the default enableViaGemfileOrMissingGemfile, but will never run rubocop from your PATH (as a result, single-file windows and workspace folders without a Gemfile may never activate the extension) • _"Run only globally, never via Bundler"_ (JSON: onlyRunGlobally) if you want to avoid running the bundled version of RuboCop, this mode will never interact with Bundler and will only run rubocop on your PATH • _"Disable the extension"_ (JSON: disable) disable the extension entirely

Or, in settings.json:

rubocop.autocorrect

The autocorrect option does what it says on the tin. if you don't want RuboCop to automatically edit your documents on save, you can disable it here:

You might want to disable this if you're using RuboCop to highlight problems but don't want it to edit your files automatically. You could also accomplish this by disabling editor.formatOnSave, but as that's a global setting across all languages, it's more straightforward to uncheck this extension setting.

Or, in settings.json:

rubocop.safeAutocorrect

This feature requires RuboCop 1.54+ to be enabled.

When autocorrect is enabled, safeAutocorrect controls its safety. By default, it is enabled to perform safe autocorrections. If you disable it, unsafe autocorrections will also be performed, you can disable it here:

Or, in settings.json:

rubocop.lintMode

This feature requires RuboCop 1.55+ to be enabled.

Run lint only cops (rubocop -l). If you only want to enable the feature as a linter like ruby -w, you can conveniently set it here:

Or, in settings.json:

rubocop.layoutMode

This feature requires RuboCop 1.55+ to be enabled.

Run layout only cops. If you only want to enable the feature as a formatter, you can conveniently set it here:

Or, in settings.json:

Furthermore, enabling autocorrect with the editor.formatOnSave to the effect of rubocop -x command line option.

rubocop.commandPath

As described above, the extension contains logic to determine which version of rubocop to launch. If you want a specific binary to run instead, you can set it here.

This will override whatever search strategy is set in rubocop.mode (except for disable, in which case the extension will remain disabled).

Note: Command-line arguments included in the executable path may be ignored when RuboCop is run via Bundler in projects with a Gemfile. For reliable argument passing, use the rubocop.commandArgs setting instead.

Or, in settings.json:

rubocop.bundleCommandPath

When the extension needs to run RuboCop via Bundler (e.g., bundle exec rubocop), it will use the system's bundle command by default. If you want to specify a different bundle executable, you can set it here.

This setting supports the same variable substitution as commandPath: • ${userHome} - User's home directory • ${pathSeparator} - OS-specific path separator • ${cwd} - Current working directory

Or, in settings.json:

rubocop.yjitEnabled

This extension supports YJIT, which can speed up the built-in language server in RuboCop. The rubocop.yjitEnabled option is enabled by default.

You can disable YJIT by unchecking.

Or, in settings.json:

rubocop.additionalLanguages

This extension is enabled by default only for files that VS Code recognizes as ruby files.…

Description from the VS Code Marketplace listing.