Sublime Text 配置 Rust 需解决 PATH 透传、working_dir 设为项目根目录、file_regex 精确匹配错误格式、rust-analyzer 使用绝对路径；常见问题源于 GUI 启动不加载 shell 环境变量。
Sublime Text 本身不提供 Rust 的“内置编译器”，所谓配置外部命令行工具，本质就是让 cargo、rustc、rust-analyzer 这些二进制在 Sublime 进程里能被正确找到并执行——不是装了就完事，而是 PATH 要透传、路径要写死、working_dir 要对齐。
Sublime 控制台里 cargo --version 报错，但终端里能跑
这是最常见也最隐蔽的问题。Sublime 启动时（尤其 macOS 从 Dock 点开、Windows 双击图标）根本不会加载你的 ~/.zshrc 或系统环境变量，它只继承极简的 GUI 环境 PATH。
- 按
Ctrl+`打开 Sublime 控制台，运行：import os; print(os.environ.get('PATH'))确认输出中是否含~/.cargo/bin（macOS/Linux）或%USERPROFILE%.cargoin（Windows） - macOS/Linux：确保
~/.cargo/bin已写入你实际用的 shell 配置（如~/.zshrc），且执行过source ~/.zshrc；更可靠的是从终端启动：subl . - Windows：必须把
%USERPROFILE%.cargoin加进「系统环境变量」（不是用户变量），加完后**右键任务栏 Sublime 图标 → 退出**，再重开 - 实在不行，构建系统里加
"shell": true，让命令走 shell 启动，能绕过部分 PATH 截断问题
working_dir 写成 ${file_path} 导致 cargo run 找不到 Cargo.toml
Sublime 默认的 ${file_path} 是当前打开文件所在目录（比如你双击 src/main.rs，它就是 src/），但 cargo 必须在项目根目录（即含 Cargo.toml 的目录）下运行，否则直接报 error: no Cargo.toml file found。
- 构建系统中必须写：
"working_dir": "${project_path:${folder}}"，不是${file_path}，也不是空着 - 打开项目时，务必用
File → Open Folder加载整个文件夹（含Cargo.toml），别只双击单个.rs文件 - 右键标签页 →
Reveal in Side Bar，确认左侧边栏顶部显示的是项目根目录，而不是src或target
错误信息不能双击跳转，file_regex 没配或格式错
构建输出里出现 src/main.rs:2:5: error[E0308]: mismatched types 这类信息，但双击没反应？说明 file_regex 没生效，错误只是纯文本日志，失去可操作性。
- 构建系统中必须加上：
"file_regex": "^(.+):([0-9]+):([0-9]+):\s*(.*)$"（注意反斜杠是双写的，JSON 字符串内） - 漏掉这行，或正则写成
s*（少了个反斜杠）、\s+（和 rustc 实际输出空格数不匹配），都会导致匹配失败 - 这个正则专为 rustc/cargo 错误格式设计，不适用于其他语言，别直接抄 ESLint 或 TypeScript 的版本
rust-analyzer 启动失败，LSP 插件找不到二进制
2026 年起 cargo install rust-analyzer 已废弃，rustup component add rust-analyzer 在 macOS/Linux 上常静默失败。LSP 插件默认依赖 PATH 查找，但 Sublime 的 PATH 不可靠，所以必须手动下载 + 绝对路径配置。
- 去 GitHub releases 下载对应平台的二进制（如
rust-analyzer-aarch64-apple-darwin），解压后得到无后缀可执行文件 - 放到固定路径：
/usr/local/bin/rust-analyzer（macOS/Linux）或C: ools ust-analyzer.exe（Windows），并确保该路径已加入系统 PATH - LSP 插件设置中，
"command"必须写绝对路径：["/usr/local/bin/rust-analyzer"]，不能只写["rust-analyzer"] - 验证：Sublime 控制台运行
import os; print(os.environ.get('PATH'))，确认该路径在输出中
真正卡住人的从来不是“怎么装”，而是 Sublime 的 PATH 隔离机制、working_dir 和项目结构的错位、以及正则表达式里一个反斜杠的缺失——这些点不亲手在控制台里敲几遍 os.environ.get('PATH')，很容易以为自己配对了。
