VSCode中rust-analyzer无法解析Cargo路径导入的WORKSPACE_HOME环境变量

问题原因 #

Cargo 不会自动解析 Cargo.toml 里的环境变量占位符，你当前的 .cargo/config.toml 配置中 WORKSPACE_HOME 的值为空，导致路径被解析为当前 crate 目录下的 ${WORKSPACE_HOME}，最终找不到对应文件。

解决方案 #

方案1：正确配置 .cargo/config.toml #

由于你的 .cargo/config.toml 位于工作区根目录下，将 WORKSPACE_HOME 设置为相对于该配置文件的工作区根路径即可：

[env]
WORKSPACE_HOME = { value = "..", relative = true }

这里 relative = true 表示 value 是相对于配置文件所在目录（即 ./.cargo/）的路径，.." 会指向工作区根目录。

方案2：在 VS Code 中为 rust-analyzer 显式设置环境变量 #

在 VS Code 的 settings.json 中，利用 VS Code 内置变量 ${workspaceFolder} 直接指定工作区根目录：

"rust-analyzer.cargo.extraEnv": {
    "WORKSPACE_HOME": "${workspaceFolder}"
}

这样 rust-analyzer 在执行 cargo metadata 时会正确获取到环境变量。

方案3：更简洁的工作区成员引用（推荐） #

如果 addrbook 是工作区的成员，完全可以不用环境变量，直接通过工作区依赖的方式引用：

1. 确保工作区根目录的 Cargo.toml 中包含该成员：

[workspace]
members = [
    "services/api",
    "pkg/addrbook"
    # 其他工作区成员
]

2. 在 services/api/Cargo.toml 中直接引用：

[dependencies]
addrbook = { workspace = true }

这种方式无需依赖环境变量，Cargo 会自动处理工作区成员的路径解析，更稳定可靠。

验证 #

修改配置后，在终端进入工作区根目录，执行 cargo metadata 或 cargo run --package api，确认路径解析正常。

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