Sublime Text 4配置Rust编译与运行环境的方法

Sublime Text 4 本身并不具备编译 Rust 的能力，所谓“配置编译运行环境”，本质上就是让 cargo 或 rustc 能在 Sublime 的进程里被正常调用、让文件能被正确识别为 Rust、让错误信息能够跳转、让构建命令能够跑通——这四个环节缺一个，Ctrl+B 要么静默失败，要么直接报 No build system。下面逐个拆解，全是实操中容易踩坑的地方。

验证 cargo 和 rustc 在 Sublime 内真正可用

终端里能跑命令，不代表 Sublime 里也能跑。Sublime 启动时读取的是自己的环境变量，和 shell 的配置文件（比如 .zshrc、.bashrc）没有直接关系。很多用户明明已经装好了 Rust，却卡在这一步，还以为是插件出了问题。

• 按 Ctrl+` 打开 Sublime 控制台，输入：
  import os; print(os.environ.get('PATH'))
  确认输出中包含 .cargo/bin 路径（例如 /Users/xxx/.cargo/bin 或 C:\Users\xxx\.cargo\bin）
• Windows 用户：必须把 %USERPROFILE%\.cargo\bin 加入「系统环境变量」，加完后彻底退出 Sublime（不是关窗口），再重新打开
• macOS/Linux 用户：通过 GUI 启动的 Sublime 不会加载 ~/.zshrc 等配置；推荐从终端用 subl 命令启动，或者确保 ~/.cargo/bin 已写入 ~/.zshrc 并执行了 source ~/.zshrc
• 如果验证失败，别急着折腾插件——先重装 rustup，再分别跑 cargo --version 和 rustc --version 确认

右下角必须显示 Rust，不是 Plain Text

Sublime 全靠状态栏右下角的语法标识来匹配 source.rust selector，语法高亮、构建系统、LSP 补全全都依赖它。选错了，后面所有配置都白搭。

• 打开任意 .rs 文件，点一下右下角状态栏（显示 Plain Text 的地方），手动选择 Rust
• 如果列表里没有 Rust，说明插件没加载：用 Package Control 安装 RustEnhanced（注意不是 Rust by rust-lang 那个），两者共存会冲突，导致状态栏卡死在 Plain Text
• 装完后进入 View → Syntax → Rust → Rust，设为默认语法，避免每次都要手动切换
• 别指望“自动识别”——Sublime 不会猜，.rs 文件默认就是 Plain Text，不手动选，selector 就不匹配，构建系统根本不会触发

构建系统必须配对 shell_cmd、working_dir 和 file_regex

网上抄来的 JSON 经常漏掉关键字段，导致 cargo 找不到 Cargo.toml，或者错误信息无法双击跳转。推荐优先使用 cargo，而不是直接调 rustc。

• 用 "shell_cmd": "cargo run"，而不是 "cmd"：前者走系统 shell，能复用 PATH 和别名；后者直调进程，Windows 上路径带空格大概率崩
• "working_dir": "${project_path:${folder}}" 必须写：否则 cargo 会在当前文件目录执行，找不到项目根目录下的 Cargo.toml，直接报 no Cargo.toml found
• 单文件快速测试可以改用：
  "shell_cmd": "rustc $file -o $file_path/$file_base_name"
  但只适用于包含 fn main() { } 的独立文件
• 改完构建系统后，必须手动启用：菜单栏 Tools → Build System → Rust 勾选你刚写的那个，Sublime 不会自动重载

rust-analyzer 必须用绝对路径，且不能靠 cargo install

cargo install rust-analyzer 已经废弃了，rustup component add rust-analyzer 在 macOS 和部分 Linux 上经常静默失败。LSP 插件找不到可执行文件，就直接放弃连接，没有任何提示。

• 去 rust-lang/rust-analyzer/releases 下载对应平台的二进制（比如 rust-analyzer-x86_64-unknown-linux-gnu）
• 解压后得到单个无后缀可执行文件，放进 /usr/local/bin/rust-analyzer（Linux/macOS）或 %USERPROFILE%\.cargo\bin\rust-analyzer.exe（Windows）
• 在终端运行 rust-analyzer --version 验证是否有效；Sublime 的 LSP 设置里 "command" 必须写绝对路径，不能只写 ["rust-analyzer"]
• 常见静默失效原因：LSP 设置里的 "scopes": ["source.rust"] 和 "syntaxes": ["Packages/Rust/Rust.sublime-syntax"] 必须和右下角选中的语法严格对应，否则依然不工作

最容易被忽视的一点是：Sublime 启动时环境变量是固化在内存里的，改完 PATH 或装完 rustup 后，必须彻底退出再重开；另外，右下角语法标识没手动切对，整个构建链就断在起点——这两处不解决，后面所有配置都是白忙。