mirror of https://github.com/rust-lang/rust.git synced 2025-04-28 11:07:42 +00:00

History

Charles Giguere a0de1723bd Add more information to VSCode extenstion README A lot of these are duplicated from the documentation or main README. While it's unfortunate to have duplicated information, the current VSCode page is very barebones and doesn't offer much confidence. This updated README offers a few more links and follows a structure similar to the official rust extension and other popular vscode extensions. The additions are, as much as possible specific to the vscode extension and not rust-analyzer as a LSP. The note about not using the official extension is also right there at the top because that's a common issue people have when trying it out. I added the sponsor section since it's common in other extensions README, but I'm not sure if it's necessary		2021-03-01 14:47:54 -05:00
..
src	Try to detect musl distros in the Code extension	2021-02-20 18:44:28 +02:00
tests	Support 'runnables' options in the vs code extension	2020-10-02 12:35:22 +03:00
.eslintignore	Fix eslint errors on .eslintrc.js and rollup.config.js	2020-08-16 23:28:26 +08:00
.eslintrc.js	handle promise catches	2021-02-07 21:27:21 +03:30
.gitignore	add rollup bundler for vscode extension	2019-09-23 23:25:16 +02:00
.vscodeignore	Remove TextMate grammar	2020-12-21 18:58:46 +02:00
icon.png	Extension icon	2020-01-15 16:07:39 +01:00
language-configuration.json	add a language configuration for VS Code	2020-12-13 19:31:11 +11:00
package-lock.json	Update our vscode npm packages	2021-02-23 11:39:19 -05:00
package.json	Update our vscode npm packages	2021-02-23 11:39:19 -05:00
ra_syntax_tree.tmGrammar.json	Fix .rast tmGrammar to account for numbers in identifiers	2020-04-22 02:00:58 +03:00
README.md	Add more information to VSCode extenstion README	2021-03-01 14:47:54 -05:00
rollup.config.js	Bump @rollup/plugin-commonjs	2020-06-27 22:37:03 +03:00
tsconfig.json	Disable ES module interop	2020-07-06 14:29:19 +03:00

README.md

rust-analyzer

Provides support for rust-analyzer: novel LSP server for the Rust programming language.

Note the extension may cause conflicts with the official Rust extension. It is recommended to disable the Rust extension when using the rust-analyzer extension.

Note the project is in alpha status: it is already useful in practice, but can't be considered stable.

Work on rust-analyzer is sponsored by

Features

code completion, imports insertion
go to definition, implementation, type definition
find all references, workspace symbol search, rename
types and documentation on hover
inlay hints
semantic syntax highlighting
a lot of assist(code actions)
apply suggestions from errors
... and many more, checkout the manual to see them all

Quick start

Install rustup the rust toolchain
Install the rust-analyzer extension

Configuration

This extension provides configurations through VSCode's configuration settings. All the configurations are under rust-analyzer.*.

See https://rust-analyzer.github.io/manual.html#vs-code-2 for more information on VSCode specific configurations.

Communication

For usage and troubleshooting requests, please use "IDEs and Editors" category of the Rust forum:

https://users.rust-lang.org/c/ide/14

Documentation

See https://rust-analyzer.github.io/ for more information.