如何设置VSCode的Rust-Analyzer以解决宏展开时语法提示缺失的问题？

本文共计1092个文字，预计阅读时间需要5分钟。

Leptos 和 Serde 是 Rust 生态系统中的两个重要库。Leptos 是一个用于构建 Web 应用的框架，它结合了 React 的组件驱动思想和 Elm 的函数式编程特性。Serde 是一个序列化/反序列化框架，它支持多种数据格式，如 JSON、YAML 和二进制等，用于将 Rust 数据结构转换为其他形式的数据。

- Leptos 的 `view!` 用于定义组件的视图。- Serde 的 `derive` 属性用于自动生成序列化和反序列化代码。

不手动开启，所有宏体内变量、属性、表达式都不会被索引——表现为：hover 看不到类型、Ctrl+Click 跳转失败、let name = props.name; 中的 props.name 标红但编译通过。

• 打开 VSCode 设置（Ctrl+, ），搜索 rust-analyzer procMacro
• 确保 rust-analyzer.procMacro.enable 选项已勾选（值为 true）
• 该设置必须作用于工作区（即写进项目根目录的 .vscode/settings.json），而非用户全局设置，避免干扰其他 Rust 项目

rust-analyzer.cargo.loadOutDirsFromCheck 必须启用

仅开 procMacro.enable 不够。rust-analyzer 需要知道宏展开后的实际输出路径（比如 target/debug/deps/xxx-proc-macro.so），而这些路径由 cargo check 运行时动态生成。默认情况下，rust-analyzer 只读取 Cargo.toml 和源码，不解析构建产物。

典型症状：宏能展开，但展开后的新类型（如 MyComponentProps）无法跳转、补全缺失、hover 显示 unknown type。

• 在项目根目录的 .vscode/settings.json 中添加：

  { "rust-analyzer.cargo.loadOutDirsFromCheck": true }

• 保存后，按 Ctrl+Shift+P → 输入 Rust Analyzer: Reload Workspace 强制重建索引
• 首次 reload 后需等待右下角状态栏显示 rust-analyzer (ready)，且有 Loaded X crates 提示，才算生效

删 target/ 后必须 reload workspace，不能只重启 VSCode

很多人遇到“昨天还好，今天 macro 全标红”，其实是手动执行了 rm -rf target/ 或 cargo clean。rust-analyzer 的语义索引严重依赖 target/ 下的 rustc 产物（尤其是 deps/ 和 incremental/）。清空后，旧缓存仍被插件持有，但对应文件已不存在，导致符号解析断裂。

错误做法：关掉 VSCode 再重开 —— rust-analyzer 会复用损坏的内存索引，问题照旧。

• 删完 target/ 后，**不要关闭窗口**，直接 Ctrl+Shift+P → Rust Analyzer: Reload Workspace
• 观察状态栏：从 (loading) 到 (ready)，期间会自动触发一次 cargo check
• 若卡在 loading 超过 45 秒，检查终端是否能跑通 cargo check --workspace --all-targets；失败则先解决编译问题

Leptos 前端 crate 必须声明 [lib]，否则 rust-analyzer 不扫描

Leptos 全栈项目常把前端逻辑放在独立 crate（如 frontend/Cargo.toml），但若该 crate 只有 [[bin]] 没有 [lib]，rust-analyzer 默认跳过它——因为只有 [lib] 才会被当作可导出模块参与跨 crate 分析。

结果是：frontend/src/lib.rs 里的 view! 完全不被识别，连语法高亮都失效，但 cargo build --release 仍能成功。

• 检查前端 crate 的 Cargo.toml，确保包含：

  [lib]<br>proc-macro = false

• proc-macro = false 是关键：Leptos 组件不是过程宏，设为 true 反而会让 rust-analyzer 尝试加载错误的 ABI
• 如果项目是 workspace，确认根 Cargo.toml 的 [workspace].members 明确列出了该 crate 路径（如 ["frontend"]）

宏展开提示失效最常卡在「开了开关但没 reload」或「crate 没被当 lib 扫描」这两步。其他配置再对，只要没过这关，view! 里永远是一片灰。