VSCode + CodeLLDB
The best debugging experience on Windows, Linux, and macOS
IntelliJ Rust
rr / Pernosco for time-traveling and postmortem debugging
Debuggers use special metadata embedded into executable to correctly match bits of machine code to lines of source code, areas of memory to variables and their types, etc.
Kinda like Source Maps for JavaScript.
Two things have to happen for a debugger to work and provide decent developer experience:
The compiler has to emit debug info.
The debugger has to be modified / extended to understand this information.
Two things have to happen for a debugger to work and provide decent developer experience:
The compiler has to emit debug info.
The debugger has to be modified / extended to understand this information.
Open standard.
Very C/C++ specific.
Has custom field types for other languages to use.
Rust tries to reuse existing C/C++ fields where possible, so many debuggers work out of the box.
DWARF standard is growing organically over time and largely implementation driven.
Come up with a new name for Rust-specific DWARF field.
Change the compiler to emit new debug info and use this field.
Change a debugger to understand this new field.
Propose the new field to be standardized, so that other debuggers can reuse the field, too.
Standardizing takes almost no time due to how few people in the world actually work on DWARF.
Proprietary format with no documentation.
Like DWARF is very C/C++ centric.
Harder to extend.
Rust tries to reuse C/C++ fields as much as possible, so debugging is still reasonable.
You may have a better experience debugging Rust on macOS or Linux than on Windows, because of PDB.
Two things have to happen for a debugger to work and provide decent developer experience:
The compiler has to emit debug info.
The debugger has to be modified / extended to understand this information.
Supports a lot of languages.
Adopts Rust-specific features quickly.
Harder to contribute in general.
Default choice for Rust.
Part of LLVM that Rust uses for compilation.
Used to support many languages, but the team decided to focus on C, C++, and Objective C only.
Has extension API for supporting other languages, which is not enough for Rust.
Rust project maintains a fork of LLDB with extended support for the language.
Part of overall LLVM fork.
Constantly updated and well-maintained.
Non-Rust-specific bug fixes get upstreamed to main LLVM repository
Rust comes with rust-gdb and rust-lldb wrappers around debuggers.
They improve visualizing Rust values printed in console.
Rust-analyzer does not come with debugger support on its own.
Instead it relies on other editor / ide plugins for debugging support.
Prompts you to install one when you open a Rust project.
LLDB-only.
Maintains it’s own fork of Rust’s LLDB with even more Rust enhancements!
Downloads it on first installation.
Seamless debugging experience.
Both Microsoft C/C++ and Native Debug support GDB and LLDB.
Microsoft’s extension offers better support for displaying PDB information on Windows.
A plugin for IDEA and CLion
Produced by JetBrain.
Like CodeLLDB also maintains it’s own fork of Rust’s LLDB for better DX.
Requires a JB license.
VSCode + CodeLLDB offer the best debugging experience across all platforms.
IntelliJ-Rust is great if that’s your IDE of choice.
Native Debug and Microsoft C/C++ extensions can work for you on platforms where only GDB is available.
rrUses GDB under the hood, supports Rust.
Pernosco - GUI debugging tool on top of rr on top of gdb - offers Rust support, too.
May help you in very difficult situations.
PDB may result in subpar debugging experience.
If possible try debugging your code on OSes other than Windows
Or try using GNU-based toolchain on Windows.
Watch expressions are limited.
Can’t use match or if expressions
Some method calls may not produce results.
Some values can’t be shown: function preferences, closures.
Breakpoints may sometimes not work in closures and in async code.
Trait objects and trait methods may be difficult for debugger to resolve.
Try to isolate the code in question into smaller functions.
Add debug logging / tracing.
Tests.
New Rust Debugging Working Group:
Unites people from Rust, GDB, and rr
people from LLVM, CodeLLDB, Rust-Analyzer, and IntelliJ Rust expressed interest in helping out.🎉
Plans:
LLVM team is open to merge Rust-specific features into LLDB directly, may not need a Rust fork, or CodeLLDB / IntelliJ forks.
Further expand DWARF to cover tricky Rust features like trait object method references.