2021-10-04
Rust Analyzer Options
type: ['null', 'string']
Custom
cargo runner extension ID.
anyOf:
{'type': 'null'}
{'type': 'array', 'items': {'type': 'object', 'properties': {'mask': {'type': 'string', 'description': 'Runnable name mask'}, 'env': {'type': 'object', 'description': 'Variables in form of { "key": "value"}'}}}}
{'type': 'object', 'description': 'Variables in form of { "key": "value"}'}
Environment variables passed to the runnable launched using
Test
or Debug
lens or
rust-analyzer.run
command.
type: boolean
default: True
Whether to show inlay
hints.
type: boolean
default: True
Whether inlay hints
font size should be smaller than editor’s font size.
type: string
default: stable
Choose
nightly
updates to get the latest features and bug fixes
every day. While stable
releases occur weekly and don’t
contain cutting-edge features from VSCode proposed APIs.
value | description |
---|---|
stable | stable updates are shipped
weekly, they don’t contain cutting-edge features from VSCode proposed
APIs but have less bugs in general. |
nightly | nightly updates are shipped
daily (extension updates automatically by downloading artifacts directly
from GitHub), they contain cutting-edge features and latest bug fixes.
These releases help us get your feedback very quickly and speed up
rust-analyzer development drastically. |
type: boolean
default: False
Whether to ask for
permission before downloading any files from the Internet.
type: ['null', 'string']
Path to
rust-analyzer executable (points to bundled binary by default). If this
is set, then #rust-analyzer.updates.channel#
setting is not
used
key | value |
---|---|
scope | machine-overridable |
type: ['null', 'object']
Extra
environment variables that will be passed to the rust-analyzer
executable. Useful for passing e.g. RA_LOG
for
debugging.
type: string
default: off
Trace requests to the
rust-analyzer (this is usually overly verbose and not recommended for
regular users).
value | description |
---|---|
off | No traces |
messages | Error only |
verbose | Full log |
key | value |
---|---|
scope | window |
type: boolean
default: False
Enable logging of VS
Code extensions itself.
type: string
default: auto
Preferred debug
engine.
value | description |
---|---|
auto | First try to use CodeLLDB, if it’s not installed try to use MS C++ tools. |
vadimcn.vscode-lldb | Use CodeLLDB |
ms-vscode.cpptools | Use MS C++ tools |
type: ['object', 'string']
default:
{
"/rustc/<id>": "${env:USERPROFILE}/.rustup/toolchains/<toolchain-id>/lib/rustlib/src/rust"
}
Optional source file mappings passed to the debug engine.
key | value |
---|---|
const | auto |
type: boolean
default: False
Whether to open up the
Debug Panel
on debugging start.
type: object
default: {}
Optional settings passed
to the debug engine. Example:
{ "lldb": { "terminal":"external"} }
type: string
default: crate
How imports should be
grouped into use statements.
value | description |
---|---|
preserve | Do not change the granularity of any imports and preserve the original structure written by the developer. |
crate | Merge imports from the same crate into a single use statement. Conversely, imports from different crates are split into separate statements. |
module | Merge imports from the same module into a single use statement. Conversely, imports from different modules are split into separate statements. |
item | Flatten imports so that each has its own use statement. |
type: boolean
default: False
Whether to enforce the
import granularity setting for all files. If set to false rust-analyzer
will try to keep import styles consistent per file.
type: string
default: plain
The path structure for
newly inserted paths to use.
value | description |
---|---|
plain | Insert import paths relative to the
current module, using up to one super prefix if the parent
module contains the requested item. |
self | Insert import paths relative to the
current module, using up to one super prefix if the parent
module contains the requested item. Prefixes self in front
of the path if it starts with a module. |
crate | Force import paths to be absolute by
always starting them with crate or the extern crate name
they come from. |
type: boolean
default: True
Group inserted imports
by the https://rust-analyzer.github.io/manual.html#auto-import[following
order]. Groups are separated by newlines.
type: boolean
default: True
Whether to allow import
insertion to merge new imports into single path glob imports like
use std::fmt::*;
.
type: boolean
default: True
Show function name and
docs in parameter hints.
type: boolean
default: True
Automatically refresh
project info via cargo metadata
on Cargo.toml
changes.
type: boolean
default: False
Activate all available
features (--all-features
).
type: array
default: ['core']
Unsets
#[cfg(test)]
for the specified crates.
key | value |
---|---|
items | {‘type’: ‘string’} |
type: array
default: []
List of features to
activate.
key | value |
---|---|
items | {‘type’: ‘string’} |
type: boolean
default: True
Run build scripts
(build.rs
) for more precise code analysis.
type: boolean
default: True
Use
RUSTC_WRAPPER=rust-analyzer
when running build scripts to
avoid compiling unnecessary things.
type: boolean
default: False
Do not activate the
default
feature.
type: ['null', 'string']
Compilation target (target triple).
type: boolean
default: False
Internal config for
debugging, disables loading of sysroot crates.
type: boolean
default: True
Run specified
cargo check
command for diagnostics on save.
type: ['null', 'boolean']
Check
with all features (--all-features
). Defaults to
#rust-analyzer.cargo.allFeatures#
.
type: boolean
default: True
Check all targets and
tests (--all-targets
).
type: string
default: check
Cargo command to use
for cargo check
.
type: ['null', 'boolean']
Do not
activate the default
feature.
type: ['null', 'string']
Check for
a specific target. Defaults to
#rust-analyzer.cargo.target#
.
type: array
default: []
Extra arguments for
cargo check
.
key | value |
---|---|
items | {‘type’: ‘string’} |
type: ['null', 'array']
List of
features to activate. Defaults to
#rust-analyzer.cargo.features#
.
key | value |
---|---|
items | {‘type’: ‘string’} |
type: ['null', 'array']
Advanced
option, fully override the command rust-analyzer uses for checking. The
command should include --message-format=json
or similar
option.
key | value |
---|---|
items | {‘type’: ‘string’} |
type: boolean
default: True
Whether to add argument
snippets when completing functions. Only applies when
#rust-analyzer.completion.addCallParenthesis#
is set.
type: boolean
default: True
Whether to add
parenthesis when completing functions.
type: boolean
default: True
Whether to show postfix
snippets like dbg
, if
, not
,
etc.
type: boolean
default: True
Toggles the additional
completions that automatically add imports when completed. Note that
your client must specify the additionalTextEdits
LSP client
capability to truly have this feature enabled.
type: boolean
default: True
Toggles the additional
completions that automatically show method calls and field accesses with
self
prefixed to them when inside a method.
type: boolean
default: True
Whether to show native
rust-analyzer diagnostics.
type: boolean
default: True
Whether to show
experimental rust-analyzer diagnostics that might have more false
positives than usual.
type: array
default: []
List of rust-analyzer
diagnostics to disable.
key | value |
---|---|
items | {‘type’: ‘string’} |
uniqueItems | True |
type: object
default: {}
Map of prefixes to be
substituted when parsing diagnostic file paths. This should be the
reverse mapping of what is passed to rustc
as
--remap-path-prefix
.
type: array
default: []
List of warnings that
should be displayed with hint severity.
The warnings will be indicated by faded text or three dots in code
and will not show up in the Problems Panel
.
key | value |
---|---|
items | {‘type’: ‘string’} |
type: array
default: []
List of warnings that
should be displayed with info severity.
The warnings will be indicated by a blue squiggly underline in code
and a blue icon in the Problems Panel
.
key | value |
---|---|
items | {‘type’: ‘string’} |
type: boolean
default: True
Expand attribute
macros.
type: string
default: client
Controls file
watching implementation.
type: array
default: []
These directories will be
ignored by rust-analyzer. They are relative to the workspace root, and
globs are not supported. You may also need to add the folders to Code’s
files.watcherExclude
.
key | value |
---|---|
items | {‘type’: ‘string’} |
type: boolean
default: True
Enables highlighting of
related references while hovering your mouse above any identifier.
type: boolean
default: True
Enables highlighting of
all exit points while hovering your mouse above any return
,
?
, or return type arrow (->
).
type: boolean
default: True
Enables highlighting of
related references while hovering your mouse break
,
loop
, while
, or for
keywords.
type: boolean
default: True
Enables highlighting of
all break points for a loop or block context while hovering your mouse
above any async
or await
keywords.
type: boolean
default: True
Use semantic tokens for
strings.
In some editors (e.g. vscode) semantic tokens override other highlighting grammars. By disabling semantic tokens for strings, other grammars can be used to highlight their contents.
type: boolean
default: True
Whether to show
documentation on hover.
type: boolean
default: True
Use markdown syntax for
links in hover.
type: boolean
default: True
Whether to show
Debug
action. Only applies when
#rust-analyzer.hoverActions.enable#
is set.
type: boolean
default: True
Whether to show
HoverActions in Rust files.
type: boolean
default: True
Whether to show
Go to Type Definition
action. Only applies when
#rust-analyzer.hoverActions.enable#
is set.
type: boolean
default: True
Whether to show
Implementations
action. Only applies when
#rust-analyzer.hoverActions.enable#
is set.
type: boolean
default: False
Whether to show
References
action. Only applies when
#rust-analyzer.hoverActions.enable#
is set.
type: boolean
default: True
Whether to show
Run
action. Only applies when
#rust-analyzer.hoverActions.enable#
is set.
type: boolean
default: True
Whether to show inlay
type hints for method chains.
type: ['null', 'integer']
default: 25
minimum:
0
Maximum length for inlay hints. Set to null to have
an unlimited length.
type: boolean
default: True
Whether to show
function parameter name inlay hints at the call site.
type: boolean
default: True
Whether to show inlay
type hints for variables.
type: boolean
default: True
Join lines inserts else
between consecutive ifs.
type: boolean
default: True
Join lines removes
trailing commas.
type: boolean
default: True
Join lines unwraps
trivial blocks.
type: boolean
default: True
Join lines merges
consecutive declaration and initialization of an assignment.
type: boolean
default: True
Whether to show
Debug
lens. Only applies when
#rust-analyzer.lens.enable#
is set.
type: boolean
default: True
Whether to show
CodeLens in Rust files.
type: boolean
default: True
Whether to show
Implementations
lens. Only applies when
#rust-analyzer.lens.enable#
is set.
type: boolean
default: True
Whether to show
Run
lens. Only applies when
#rust-analyzer.lens.enable#
is set.
type: boolean
default: False
Whether to show
Method References
lens. Only applies when
#rust-analyzer.lens.enable#
is set.
type: boolean
default: False
Whether to show
References
lens. Only applies when
#rust-analyzer.lens.enable#
is set.
type: boolean
default: True
Internal config: use
custom client-side commands even when the client doesn’t set the
corresponding capability.
type: array
default: []
Disable project
auto-discovery in favor of explicitly specified set of projects.
Elements must be paths pointing to Cargo.toml
,
rust-project.json
, or JSON objects in
rust-project.json
format.
key | value |
---|---|
items | {‘type’: [‘string’, ‘object’]} |
type: ['null', 'integer']
minimum: 0
Number of syntax trees
rust-analyzer keeps in memory. Defaults to 128.
type: boolean
default: True
Whether to show
can't find Cargo.toml
error message.
type: boolean
default: True
Enable support for
procedural macros, implies
#rust-analyzer.cargo.runBuildScripts#
.
type: ['null', 'string']
Internal
config, path to proc-macro server executable (typically, this is
rust-analyzer itself, but we override this in tests).
type: ['null', 'string']
Command
to be executed instead of ‘cargo’ for runnables.
type: array
default: []
Additional arguments to
be passed to cargo for runnables such as tests or binaries. For example,
it may be --release
.
key | value |
---|---|
items | {‘type’: ‘string’} |
type: ['null', 'string']
Path to
the Cargo.toml of the rust compiler workspace, for usage in
rustc_private projects, or “discover” to try to automatically find
it.
Any project which uses rust-analyzer with the rustcPrivate crates
must set
[package.metadata.rust-analyzer] rustc_private=true
to use
it.
This option is not reloaded automatically; you must restart rust-analyzer for it to take effect.
type: array
default: []
Additional arguments to
rustfmt
.
key | value |
---|---|
items | {‘type’: ‘string’} |
type: ['null', 'array']
Advanced
option, fully override the command rust-analyzer uses for
formatting.
key | value |
---|---|
items | {‘type’: ‘string’} |
type: boolean
default: False
Enables the use of
rustfmt’s unstable range formatting command for the
textDocument/rangeFormatting
request. The rustfmt option is
unstable and only available on a nightly build.
type: string
default: workspace
Workspace symbol
search scope.
value | description |
---|---|
workspace | Search in current workspace only |
workspace_and_dependencies | Search in current workspace and dependencies |
type: string
default: only_types
Workspace symbol
search kind.
value | description |
---|---|
only_types | Search for types only |
all_symbols | Search for all symbols kinds |