VSCode中Rust项目非main.rs文件Inlay提示及悬停信息失效问题

问题描述 #

在Linux系统下使用VSCode学习Rust，项目结构如下：

.
├── src
│   ├── 01_hello_world
│   │   ├── comm.rs
│   │   └── mod.rs
│   └── main.rs
├── target
├── Cargo.lock
└── Cargo.toml

main.rs的Inlay提示与悬停信息功能正常，但子模块内的.rs文件（如comm.rs）该功能完全失效；嵌套子模块结构中也存在同样问题：

...
│   ├── 01_hello_world
│   │   ├── comments
│   │   │   └── mod.rs
│   │   └── mod.rs
...

原因及解决办法 #

• 模块未纳入编译路径：Cargo仅编译被主入口（main.rs/lib.rs）直接或间接引用的模块，未被引用的文件rust-analyzer无法解析上下文。

  • 解决：在main.rs中引入顶层子模块（注意数字开头的模块名需用引号包裹）：

    mod "01_hello_world";
    

    在01_hello_world/mod.rs中引入同级的comm.rs：

    mod comm;
    

    嵌套的comments模块则在01_hello_world/mod.rs中添加：

    mod comments;
    

• 项目根目录未被正确识别：VSCode若未打开包含Cargo.toml的根文件夹，rust-analyzer仅解析main.rs，忽略子模块。

  • 解决：直接打开项目根目录（含Cargo.toml的文件夹）；若已打开，按Ctrl+Shift+P打开命令面板，执行Rust: Reload Workspace重新加载。

• rust-analyzer缓存异常：模块结构修改后，缓存可能导致解析错误。

  • 解决：打开命令面板执行Rust: Clear Workspace Cache，再重新加载工作区；或手动删除target文件夹后执行cargo build重新编译。

• 模块引用语法错误：数字开头的模块名（如01_hello_world）直接用mod 01_hello_world;会报错，必须用字符串包裹，否则rust-analyzer无法正确解析。

内容的提问来源于stack exchange，提问作者Ουιλιαμ Αρκευα