rust-analyzer

rust-analyzer. It is a language server implementation for the Rust programming language, designed to provide rich IDE features like code completion, goto definition, and refactoring across various code editors. The project represents a modern, from-scratch reimagining of IDE support for Rust, built to be faster and more maintainable than its predecessor. It is a core component of the Rust Project's official tooling ecosystem and is developed openly on GitHub.

Overview

The project emerged from community efforts to address limitations in the original Rust Language Server (RLS), with key design goals centered on performance and correctness. It is built upon the foundational rustc compiler, but implements its own incremental query-based architecture for responsiveness. Development is spearheaded by companies like Ferrous Systems with significant contributions from the broader Rust Project community and sponsorship from organizations such as the Rust Foundation. Its adoption has been accelerated by integration into popular tools like Visual Studio Code via a dedicated extension.

Features

It provides comprehensive IDE functionalities including precise code completion driven by type inference and trait resolution, and reliable goto definition across project boundaries and dependencies. Advanced features include inlay hints showing inferred types and parameter names, semantic syntax highlighting, and support for major refactoring operations like renaming symbols. It offers real-time diagnostics, integrating warnings from both the rustc compiler and external linters like Clippy, and supports Cargo-based workspaces, build scripts, and procedural macros. Experimental features often include run configurations and support for newer Rust Edition specifications.

Architecture

Its core is built on a demand-driven, query-based system inspired by the salsa library, which caches intermediate results for fast re-analysis. It utilizes the rowan library for lossless syntax tree representation and the tt crate for handling token trees from macros. The architecture separates a persistent global state, which holds crate graphs and configuration, from a mutable project state that handles open files. It interacts with the rustc compiler as a library to leverage its type system and borrow checker, but maintains its own indexes for speed, communicating via the Language Server Protocol to frontends like Visual Studio Code or Neovim.

Integration and tooling

Primary integration for most users is through the Visual Studio Code marketplace extension, which is officially maintained. It is also supported in Vim and Neovim via plugins like coc.nvim or LanguageClient-neovim, and in Sublime Text through the LSP package. Editors like IntelliJ IDEA have their own Rust plugin but can interface with it for specific features. The server can be installed via Rustup as a component, managed through Cargo, or built from source on GitHub. It works seamlessly within Cargo workspaces and can be configured via JSON settings files.

Development and community

The project is developed openly on GitHub, with major contributions coordinated by Ferrous Systems and other community members. It follows the Rust Project's governance model, with design discussions occurring on its GitHub repository and the official Rust Internals forum. Development is closely aligned with the Rust Compiler team to share infrastructure like the chalk trait solver. The community maintains extensive documentation and accepts contributions through a standard process involving pull requests and review by maintainers. Its roadmap is often discussed in tandem with the broader Rust Language evolution.

Category:Rust (programming language) Category:Language Server Protocol implementations Category:Free integrated development environments Category:Free software programmed in Rust