rust-analyzer无法识别workspace共享依赖，根本原因是未在workspace根目录（含顶层cargo.toml）打开项目，导致其不加载[workspace]配置；必须用终端进入根目录执行code .，并确保rust-analyzer.procmacro.enable和loadoutdirsfromcheck已启用、子crate依赖声明为workspace = true且resolver = "2"已显式设置。
rust-analyzer 无法识别 workspace 共享依赖
你改了 Cargo.toml 里的 [workspace.dependencies]，但 rust-analyzer 仍报 unresolved import 或跳转失效——这不是代码错，是它根本没加载 workspace 配置。rust-analyzer 默认只读当前 crate 的 Cargo.toml，不自动上溯到 workspace 根目录。
- 确保你在 VSCode 中打开的是 workspace 根目录（含顶层
Cargo.toml），不是某个子 crate 文件夹 - 状态栏右下角必须显示
Rust (rust-analyzer)，若显示Rust (RLS)或空白，说明 rust-analyzer 没激活：关掉所有窗口，用终端进入根目录后执行code . - 若仍卡在 “Loading…”，按
Ctrl+Shift+P→ 输入Rust Analyzer: Reload Workspace手动触发重载
cargo check 报 “found multiple versions of package X”
错误信息类似 error: found multiple versions of package `serde` in the dependency graph，说明 workspace resolver 没生效或子 crate 绕过了统一版本约束。
- 检查 workspace 根
Cargo.toml是否启用了新版 resolver：resolver = "2"必须显式声明，否则默认用旧版，不强制统一版本 - 子 crate 的
Cargo.toml中引用 workspace 依赖时，**不能写版本号**，例如：serde = { version = "1.0" }是错的；应写成：serde = { workspace = true } - 如果某子 crate 用了
path = "../xxx"引用本地 crate，而该 crate 又依赖了不同版本的serde，就会绕过 workspace 约束——此时需统一其依赖，或改用[workspace.dependencies]定义并设workspace = true
VSCode 调试时 cargo build 失败，提示依赖冲突
F5 启动调试失败，终端输出 failed to select a version for `tokio` 类错误，本质是 cargo build 在构建可执行目标时，因 workspace 内部依赖图未收敛而拒绝继续。
- 别直接点 ▶️ 或 F5 就跑——先在内置终端手动运行
cargo check，确认无语法/类型错误；再运行cargo build看是否真能成功生成 binary - 若
cargo build也失败，优先删掉Cargo.lock（在 workspace 根目录），然后cargo clean，最后cargo build—— lock 文件可能残留旧版本冲突记录 - launch.json 中的
program字段必须指向target/debug/xxx下已成功构建的二进制文件，而不是源码路径；未 build 就调试，必然报Cannot find program
rust-analyzer 占用 CPU 高、索引慢，且 workspace 成员间跳转失灵
大型 workspace（如 >20 个 members）下，rust-analyzer 默认会为每个 crate 单独索引，导致重复解析、内存暴涨、跨 crate 跳转失败。
- 在项目级
.vscode/settings.json中启用 workspace-aware 优化："rust-analyzer.cargo.loadOutDirsFromCheck": true，让 analyzer 复用cargo check输出，避免二次编译 - 禁用耗资源的 proc-macro 支持：
"rust-analyzer.procMacro.enabled": false，除非你真在写宏并需要 IDE 补全 - 确保所有成员 crate 的
[package] edition一致（如都用edition = "2021"），混用 edition 会导致 analyzer 解析策略分裂，跳转逻辑错乱
workspace = true 声明和 rust-analyzer 对根目录的严格识别共同锁死的。任何一处漏掉，都会在保存、检查、构建、调试任一环节突然崩出版本冲突。
