VS Code中如何让rust-analyzer找到标准库hashbrown的定义？

问题背景 #

在VS Code使用rust-analyzer v0.3.2037开发Rust crate时，可正常跳转到std::collections::HashMap的定义，但无法跳转其中引入的hashbrown或别名base，提示“未找到定义”，更换rust-analyzer版本后问题仍存在。

项目配置：

[package]
name = "world_hello"
version = "0.1.0"
edition = "2021"

[dependencies]

代码内容：

use std::collections::HashMap;

fn main() {
    let _ = HashMap::<i32, i32>::new();
    println!("Hello, world!")
}

当前Rust版本信息：

Default host: x86_64-apple-darwin
rustup home:  /Users/bytedance/.rustup

installed toolchains
--------------------

stable-x86_64-apple-darwin (default)
nightly-2023-12-28-x86_64-apple-darwin
nightly-2024-01-26-x86_64-apple-darwin
nightly-x86_64-apple-darwin

active toolchain
----------------

stable-x86_64-apple-darwin (default)
rustc 1.77.2 (25ef9e3d8 2024-04-09)

解决方案 #

1. 安装对应工具链的Rust源代码 #

rust-analyzer需要标准库的完整源代码才能解析深层依赖跳转，执行以下命令安装当前默认工具链的源代码：

rustup component add rust-src --toolchain stable-x86_64-apple-darwin

如果需要使用nightly工具链，同步安装对应版本的源代码：

rustup component add rust-src --toolchain nightly-x86_64-apple-darwin

2. 配置rust-analyzer指向本地源代码路径 #

打开VS Code设置（快捷键Cmd+,），搜索rust-analyzer.rust-src.path，将路径设置为你的rust-src存放目录，示例路径：

/Users/bytedance/.rustup/toolchains/stable-x86_64-apple-darwin/lib/rustlib/src/rust/library

也可直接编辑settings.json添加配置：

{
    "rust-analyzer.rust-src.path": "/Users/bytedance/.rustup/toolchains/stable-x86_64-apple-darwin/lib/rustlib/src/rust/library"
}

3. 清除rust-analyzer缓存并重启VS Code #

• 打开VS Code命令面板（快捷键Cmd+Shift+P），执行Rust Analyzer: Clean Cache
• 关闭并重新启动VS Code，等待rust-analyzer重新加载项目索引

4. 临时添加hashbrown依赖到项目（可选） #

若上述方法无效，可在Cargo.toml中手动添加hashbrown依赖，让rust-analyzer直接解析该 crate：

[dependencies]
hashbrown = "0.14"

执行cargo build后，rust-analyzer即可识别hashbrown的定义，跳转功能恢复。后续若不需要该依赖可直接移除。

内容的提问来源于stack exchange，提问作者user4300698