【VSCODE 插件 rust-analyzer 使用】打开文件夹

方法一：使用"多根工作区" (Multi-root Workspaces) ------ 推荐

将多个独立的 Rust 项目添加到同一个 VSCode 窗口中。

操作步骤：

1. 打开第一个项目 ：
   • 在 VSCode 中，点击 文件 (File) -> 打开文件夹 (Open Folder)。
   • 选择第一个项目路径，例如 .../rust/project_a。
2. 添加第二个项目 ：
   • 点击菜单栏 文件 (File) -> 将文件夹添加到工作区... (Add Folder to Workspace...)。
   • 选择第二个项目路径，例如 .../rust/project_b。
   • 重复此步骤添加更多项目。
3. 保存工作区 (可选但推荐) ：
   • 点击 文件 (File) -> 将工作区另存为... (Save Workspace As...)。
   • 保存为一个 .code-workspace 文件（例如 my-rust-projects.code-workspace）。以后你只需要双击这个文件，就能一次性打开所有项目。

rust-analyzer 的行为：

• 共享实例 ：在这种模式下，VSCode 会启动一个 rust-analyzer 服务端进程。
• 自动发现 ：rust-analyzer 会自动检测当前工作区中的所有根文件夹。如果每个文件夹下都有 Cargo.toml，它会同时加载它们。
• 资源占用：相比开多个窗口，这种方式更节省服务器内存，因为语言服务器是复用的。

方法二：使用"新窗口" (New Window) ------ 完全隔离

如果希望每个项目在完全独立的环境中运行（互不干扰），可以使用新窗口打开。

操作步骤：

1. 在已打开的项目窗口中，按下快捷键 Ctrl + Shift + N (Windows/Linux) 或 Cmd + Shift + N (macOS) 打开一个新的空 VSCode 窗口。
2. 在新窗口中，打开第二个项目文件夹。

rust-analyzer 的行为：

• 独立实例 ：每个窗口都会启动一个独立 的 rust-analyzer 进程。
• 重新加载：每个窗口都会独立加载自己的依赖和索引。
• 缺点 ：如果打开 5 个项目，服务器上就会运行 5 个 rust-analyzer 进程，这会消耗大量的 CPU 和内存，可能导致服务器卡顿。

优化 rust-analyzer 在多项目下的体验

如果采用方法一（多根工作区） ，但发现 rust-analyzer 加载缓慢或报错，通常是因为它试图监控所有文件（包括庞大的 target 构建目录）。

建议在 .code-workspace 文件或用户设置中添加以下配置，以提升性能：

{
  "rust-analyzer.cargo.buildScripts.enable": true,
  // 排除不需要监控的目录，防止 rust-analyzer 卡死
  "files.watcherExclude": {
    "**/target/**": true,
    "**/node_modules/**": true,
    "**/.git/objects/**": true
  },
  // 如果自动发现失效，可以显式指定 Cargo.toml 路径
  // "rust-analyzer.linkedProjects": [
  //   "./project_a/Cargo.toml",
  //   "./project_b/Cargo.toml"
  // ]
}

总结

• 如果想在一个窗口里同时看代码、统一跳转定义：用方法一（多根工作区） 。这是最高效的方式，rust-analyzer 不会重复加载，而是统一管理。
• 如果你需要完全隔离环境（比如编译环境不同）：用方法二（新窗口） 。但这会导致 rust-analyzer 为每个项目单独启动，资源消耗大。

1. 显式配置 rust-analyzer 使用正确的路径 (最推荐)

这是最直接、最可靠的解决方法。我们需要在 VSCode 的设置中明确告诉 rust-analyzer rustc 和 cargo 的绝对路径。

1. 在远程终端中，执行以下命令，确认这两个文件的路径：

   which rustc
   which cargo

   根据查找的信息，路径如：

   • rustc: /home/test/.cargo/bin/rustc
   • cargo: /home/test/.cargo/bin/cargo

2. 在 VSCode 中打开设置 (Ctrl+,)。

3. 在右上角点击图标，选择 在 settings.json 中编辑。

4. 在 settings.json 文件中，添加或修改以下配置：json

   {
       "rust-analyzer.cargo.path": "/home/test/.cargo/bin/cargo",
       "rust-analyzer.rustc.path": "/home/test/.cargo/bin/rustc"
   }

5. 保存文件后，打开命令面板 (Ctrl+Shift+P)，执行 Rust Analyzer: Restart Server 来重启语言服务器。