VSCode 安装 rust-analyzer 插件后代码提示不工作怎么排查

VSCode 安装 rust-analyzer 后代码提示不工作，通常是因为环境变量未继承、项目根目录识别错误或存在插件冲突。优先在集成终端验证 Rust 工具链可用性，确保打开含 Cargo.toml 的文件夹，并禁用旧的 rust-lang.rust 插件。

先说结论：rust-analyzer 依赖本地 Cargo 环境和正确的项目上下文，插件本身无问题时应重点排查路径配置和工作区设置。

命令速用版

在 VSCode 集成终端（Ctrl+`）中依次执行以下命令，确认工具链可见性：

cargo `--version`
rustc `--version`
rustup update

若命令报错 command not found，说明环境变量未配置或未继承到 VSCode。

rust-analyzer 不是独立运行的程序，它需要调用后端的 cargo 和 rustc 来解析项目结构。

常见原因包括 VSCode 启动方式导致 PATH 环境变量未加载、项目根目录缺少 Cargo.toml 导致无法识别工作区、或旧版 Rust 插件占用语言服务器端口导致冲突。

验证终端环境：在 VSCode 集成终端运行 cargo `--version`。若失败，macOS/Linux 用户需通过终端执行 code . 启动 VSCode，Windows 用户检查系统 PATH 是否包含 .cargo\bin。
检查项目根目录：确保通过 File → Open Folder 打开含 Cargo.toml 的目录，不要直接打开单个 .rs 文件。
排查插件冲突：打开扩展面板，搜索 Rust，禁用图标为红黑齿轮的 rust-lang.rust 插件，仅保留蓝色原子图标的 rust-analyzer。
重启语言服务器：按 Ctrl+Shift+P 输入 Rust Analyzer: Restart Server，查看输出面板日志。

打开任意 .rs 文件，查看 VSCode 右下角状态栏。

若显示 rust-analyzer 且伴有 Loaded N crates 字样，说明插件已正常加载项目。

若显示 Loading... 持续不变或报错 Failed to run cargo metadata，需检查 Cargo.toml 路径及终端环境变量。

macOS 路径继承：从桌面图标启动 VSCode 不会加载 ~/.zshrc，导致找不到 cargo 命令。
过程宏支持：使用 Leptos 等框架时，需在设置中启用 rust-analyzer.procMacro.enable 和 rust-analyzer.cargo.loadOutDirsFromCheck。
工作区信任：若左下角提示 Restricted Mode，需信任文件夹才能启用扩展功能。

通常是 cargo metadata 执行失败。检查集成终端能否运行 cargo check，若终端正常则尝试删除 target 目录后重启 VSCode。

确认当前文件语言模式不是 Plain Text，且已打开含 Cargo.toml 的文件夹而非单个文件。

需在设置中开启过程宏支持，勾选 rust-analyzer.cargo.loadOutDirsFromCheck 并重启服务器。