Sublime Text 的 Rust 开发环境需同步 PATH、二进制路径与构建系统语义：GUI 启动不加载 shell 配置，须验证控制台中 os.environ.get('PATH') 是否含 ~/.cargo/bin；rust-analyzer 必须手动下载并用绝对路径配置；Build System 中 working_dir 必设为项目根，file_regex 需匹配错误格式；语法须手动设为 Rust，否则全功能失效。
Sublime Text 的 Rust 开发环境不是“装一次就永久可用”的东西，2026 年起 rust-analyzer 已弃用 cargo install，rustup component add 在 macOS/Linux 上常静默失败，RustEnhanced 插件也已明确标注为 Sublime Text 4 官方包——更新配置本质是同步三件事：PATH、二进制路径、构建系统语义。
验证 cargo 和 rustc 是否真在 Sublime 进程里可用
终端能跑 cargo --version ≠ Sublime 能调用 cargo。GUI 启动的 Sublime 不加载 ~/.zshrc 或环境变量，PATH 很可能被截断。
- 按
Ctrl+`打开 Sublime 控制台，执行：import os; print(os.environ.get('PATH')) - 检查输出是否含
~/.cargo/bin（macOS/Linux）或%USERPROFILE%.cargoin（Windows） - 若缺失：macOS/Linux 用户需确保该路径写入 shell 配置并
source；Windows 用户必须加到「系统环境变量」，且彻底退出 Sublime（右键任务栏 → 退出），再重开 - 加
"shell": true到 Build System 是最稳妥兜底方案——它让命令走 shell，继承完整 PATH
rust-analyzer 必须用绝对路径手动部署
2026 年起 cargo install rust-analyzer 已废弃，LSP-rust-analyzer 插件自动下载常因网络失败；更糟的是，即使下载成功，LSP 仍可能因 PATH 不一致找不到可执行文件。
- 去 GitHub releases 下载对应平台二进制（如
rust-analyzer-aarch64-apple-darwin） - 解压后得到无后缀可执行文件（macOS/Linux）或
.exe（Windows），放进固定路径：/usr/local/bin/rust-analyzer或C: ools ust-analyzer.exe - 确认该路径已加入系统 PATH，并在 Sublime 控制台再次验证
os.environ.get('PATH') - LSP 设置中
"command"字段必须写绝对路径："command": ["/usr/local/bin/rust-analyzer"]
，不能只写["rust-analyzer"]
Build System 必须重配 working_dir 和 file_regex
旧配置若还用 "working_dir": "${file_path}"，cargo run 会因找不到 Cargo.toml 直接报错；若漏掉 file_regex，错误就只是纯文本，无法双击跳转。
-
working_dir必须设为项目根："working_dir": "${project_path:${folder}}"，不是${file_path}—— 因为cargo只认含Cargo.toml的目录 - 打开项目务必用 File → Open Folder，别双击单个
.rs文件；右键标签页 → Reveal in Side Bar 确认当前视图在项目根层级 -
file_regex必须匹配 rustc/cargo 错误格式（如src/main.rs:2:5: error[E0308]: mismatched types）："file_regex": "^(.+):([0-9]+):([0-9]+):\s*(.*)$"
注意反斜杠要双写，\s*不能写成s*
RustEnhanced 和语法识别必须手动激活
Sublime 默认不把 .rs 文件当 Rust 代码处理，状态栏显示 Plain Text 就等于整个生态失效：语法高亮、构建触发、LSP 补全全挂。
- 点右下角状态栏（显示
Plain Text处），手动选 Rust；若列表里没有，说明插件未加载 - 用 Package Control 安装
Rust（by rust-lang），**不是**RustEnhanced（后者是旧名，二者共存会导致卡死） - 安装后进 View → Syntax → Rust → Rust，设为默认，避免每次手动切
- 项目级配置推荐写进
.sublime-project并纳入版本控制，例如启用 Clippy："rust_syntax_checking_method": "clippy"
最易忽略的点：PATH 验证必须在 Sublime 控制台里做，不是终端；rust-analyzer 二进制必须放固定路径并用绝对路径引用；working_dir 和 file_regex 缺一不可——它们不是“锦上添花”，而是 Cargo 构建和错误跳转的刚性前提。
