Sublime Text 配置 Rust 开发环境：避开那些“装了也白装”的坑
想给 Sublime Text 配上得心应手的 Rust 开发环境？这事儿听起来简单，但实际操作时，你会发现从语法高亮到智能感知，每一步都可能藏着“陷阱”。尤其是那个关键的 rust-analyzer，它可不是靠 cargo install 就能轻松搞定的——如果方法不对，装了也白装，LSP 插件根本认不出来，智能感知永远停留在灰色图标上。
rust-analyzer 二进制必须手动下载，不能 cargo install
首先得明确一个关键变化：从 Rust 1.75 版本开始，cargo install rust-analyzer 这个命令就已经被废弃了。如果你还按老方法执行，终端里看似一切顺利，但实际上生成的是一个无效的存根文件。等到 LSP 插件尝试调用它时，结果要么是报出 spawn ENOENT 错误，要么就是静默失败，让你摸不着头脑。
正确的做法，是回归“手动安装”：
- 前往 rust-lang/rust-analyzer 的 GitHub releases 页面，下载对应你操作系统的压缩包（比如
rust-analyzer-x86_64-unknown-linux-gnu.gz）。 - 解压后，你会得到一个单独的可执行文件（Linux/macOS 下无后缀，Windows 下带
.exe后缀）。 - 把这个文件放到一个固定的路径下，例如
/home/username/.cargo/bin/rust-analyzer（Linux/macOS）或C:Usersusername.cargoinust-analyzer.exe（Windows）。 - 完成后，可以在终端里运行
rust-analyzer --version验证一下。如果报错说命令找不到，别慌——这很可能只是系统 PATH 没配置，我们下一步在 LSP 设置里直接指定绝对路径就能绕过这个问题。
LSP 设置里 command 必须写绝对路径
接下来是配置 Sublime Text 的 LSP 插件。这里有个常见的误解：以为在终端能运行的命令，在 Sublime 里也一样。其实不然，Sublime 的 LSP 插件并不继承你 shell 环境中的 PATH 变量。这意味着，哪怕你在终端里输入 which rust-analyzer 能显示完美路径，LSP 插件也照样找不到它。
所以，千万别简单地写成 "command": ["rust-analyzer"]，这种写法只在 PATH 全局生效时才管用，而 Sublime 启动时基本不会去读取你的 ~/.zshrc 或 ~/.bashrc 配置文件。
稳妥的配置步骤如下：
- 打开 Preferences → Package Settings → LSP → Settings。
- 在用户配置中，明确指定完整的绝对路径：
{ "clients": { "rust-analyzer": { "command": ["/home/username/.cargo/bin/rust-analyzer"], "enabled": true, "initializationOptions": { "cargo": { "loadOutDirsFromCheck": true }, "procMacro": { "enable": true } }, "languages": [{ "languageId": "rust", "scopes": ["source.rust"], "syntaxes": ["Packages/Rust/Rust.sublime-syntax"] }] } } } - Windows 用户需要特别注意路径中的反斜杠，要么双写，要么直接使用正斜杠：
"command": ["C:/Users/username/.cargo/bin/rust-analyzer.exe"]。 - 保存配置后，重启 Sublime Text。关键一步来了：务必通过 File → Open Folder 打开一个包含
Cargo.toml文件的项目根目录，而不是仅仅打开一个单独的.rs文件。只有这样，才能正确触发 rust-analyzer 的 workspace 初始化。
语法高亮失效？先看右下角是不是显示 Rust
很多人配置完 LSP 后，发现悬停提示没反应、跳转定义失败，第一反应就是 LSP 配错了。但很多时候，问题其实出在更前面一步：文件压根没被编辑器识别为 Rust 代码。如果连 source.rust 这个语法作用域都不存在，LSP 客户端根本就不会加载。
排查方法很简单：
- 打开任意一个
.rs文件，看一眼编辑器右下角的状态栏。它显示的是Plain Text还是Rust？ - 如果显示的是
Plain Text，点击它，从列表里手动选择Rust。如果列表里压根没有Rust这个选项，那说明官方的 Rust 语法插件要么没装，要么没加载成功（注意：别装RustEnhanced插件，它和原生的 Rust 插件可能会冲突）。 - 正确的安装方式是：通过
Package Control: Install Package搜索Rust，选择描述里带有 “by rust-lang” 字样的那个官方插件。 - 安装后，可以将其设为默认语法：通过菜单 View → Syntax → Rust → Rust 来设置，避免每次重新打开文件都要手动切换。
构建系统里 cargo 找不到？别硬塞 PATH
当你想用 Ctrl+B 快速构建项目时，如果遇到报错 'cargo' is not recognized 或 command not found，这通常不是插件的问题。根源在于 Sublime Text 启动时，没有获取到你 shell 中的所有环境变量。试图用 launchctl setenv 或修改系统级 PATH 来修复，往往是治标不治本，还可能引发权限问题。
更稳定的方案是，为 Sublime Text 创建一个自定义的构建系统：
- 通过菜单 Tools → Build System → New Build System 新建一个构建系统文件。
- 在文件中，直接写死
cargo的绝对路径，并使用shell_cmd而非cmd（这样能更好地兼容路径中的空格）：{ "shell_cmd": "/home/username/.cargo/bin/cargo build --color=always", "file_regex": "^(.*?):([0-9]+):([0-9]+):.*$", "working_dir": "${project_path:${folder}}", "selector": "source.rust" } - macOS 或 Linux 用户也可以尝试使用
"shell_cmd": "bash -c 'cargo build'"来强制通过 shell 解析命令，但稳定性不如直接使用绝对路径。 - Windows 用户如果路径中包含空格（例如
C:UsersJohn Doe...），必须用双引号将整个命令包裹起来："shell_cmd": ""C:\Users\John Doe\.cargo\bin\cargo.exe" build"。
最后，再提一个高频问题：如果你在 LSP 日志里反复看到 No workspace folder 的提示，大概率是因为你只是用 Sublime 打开了一个孤立的 .rs 文件。记住，cargo check 的输出路径、依赖解析、过程宏展开，所有这些高级功能都依赖于 Cargo.toml 文件的存在以及正确的加载时机。所以，请务必养成习惯，使用 File → Open Folder 来打开整个 Cargo 项目的根目录。
