rustaceanvim
A Neovim plugin that supercharges Rust development with advanced rust-analyzer integration, debugging, and tooling.
What is rustaceanvim?
Rustaceanvim is a feature-rich Neovim plugin designed to enhance the Rust programming experience. It serves as a heavily modified fork of rust-tools.nvim, providing deep integration with rust-analyzer and additional Rust-specific tooling beyond Neovim's standard LSP support. The plugin solves the problem of needing advanced Rust development features like debugging, test execution, and macro expansion directly within the editor.
Rust developers using Neovim who need advanced, rust-analyzer-specific features beyond the basic LSP support provided by nvim-lspconfig. It is tailored for developers working on Cargo projects who require integrated debugging, test execution, and code analysis tools.
Developers choose Rustaceanvim for its 'just works' philosophy with lazy initialization by design, avoiding unnecessary setup calls and dependencies like lspconfig. Its unique selling point is providing a comprehensive suite of Rust-specific features—like debugging integration, macro expansion, and enhanced diagnostics—in a single, streamlined plugin that automatically configures the rust-analyzer LSP client.
Overview
🦀 Supercharge your Rust experience in Neovim! A heavily modified fork of rust-tools.nvim
Use Cases
Best For
- Debugging Rust programs directly within Neovim using nvim-dap with automatic configuration loading.
- Executing Cargo runnables and testables with background test execution and diagnostic reporting.
- Expanding Rust macros recursively and viewing syntax trees or HIR/MIR representations for code analysis.
- Enhancing error diagnostics with explanations from the Rust error codes index and navigating related diagnostics.
- Integrating with neotest for Rust test discovery and execution, providing an alternative to neotest-rust.
- Performing advanced code refactoring like intelligent line joining and structural search replace (SSR) within buffers.
Not Ideal For
- Developers using Neovim versions older than 0.12, as the plugin requires newer versions for compatibility and features.
- Projects that are not Cargo-based or consist of standalone Rust files, since core features like diagnostics and tool execution rely on Cargo project context.
- Users who prefer to manually configure their LSP client with tools like nvim-lspconfig, as Rustaceanvim's automatic setup can conflict with existing configurations.
- Teams seeking a minimal, lightweight Rust development setup without the overhead of advanced debugging and testing integrations.
Pros & Cons
Pros
Automatically configures nvim-dap for Rust debugging with commands like :RustLsp debug, loading debug configurations from rust-analyzer without manual setup.
Provides unique features such as recursive macro expansion, syntax tree viewing, and HIR/MIR inspection, extending beyond standard LSP capabilities.
Implements a 'just works' approach with lazy initialization, eliminating the need for manual setup calls and dependencies like lspconfig.
Offers background test execution with diagnostic reporting and integrates with neotest, improving workflow for testing and running Cargo projects.
Cons
Requires additional plugins like nvim-dap and debug adapters such as codelldb, which can be challenging to install and configure, especially on non-Nix systems.
Automatically sets up rust-analyzer, so using other LSP configurations simultaneously can cause conflicts, necessitating careful setup in shared environments.
Diagnostics and many features are dependent on Cargo projects, making it less effective for editing individual Rust files without a project context.
Frequently Asked Questions
Related Projects
nvim-lspconfigQuickstart configs for Nvim LSP
lspsaga.nvimimprove neovim lsp experience
none-ls.nvimnull-ls.nvim reloaded / Use Neovim as a language server to inject LSP diagnostics, code actions, and more via Lua.
nvim-lintAn asynchronous linter plugin for Neovim complementary to the built-in Language Server Protocol support.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.