Sublime控制台cargo --version报错而终端正常，是PATH隔离所致；需检查控制台PATH是否含.cargo/bin、设"working_dir":"${project_path:${folder}}"、加"shell":true，并配file_regex支持错误跳转。
Sublime 控制台里 cargo --version 报错，但终端能跑
这是 PATH 隔离导致的最常见假象。Sublime 启动时不会加载你的 ~/.zshrc 或 ~/.bash_profile，所以即使终端里一切正常，Sublime 进程的 PATH 可能只有 /usr/bin:/bin。
验证方式：按 Ctrl+` 打开 Sublime 控制台，执行：
import os; print(os.environ.get('PATH'))
检查输出是否包含：
- macOS/Linux：
~/.cargo/bin（如/Users/xxx/.cargo/bin） - Windows：
%USERPROFILE%.cargoin（如C:Usersxxx.cargoin）
若缺失：
- macOS/Linux：确保
~/.cargo/bin已写入你实际用的 shell 配置（如~/.zshrc），并执行source ~/.zshrc；更可靠的是从终端启动：subl . - Windows：把
%USERPROFILE%.cargoin加进「系统环境变量」（不是用户变量），然后彻底退出 Sublime（右键任务栏 → 退出），再重开
加 "shell": true 到 Build System 是兜底方案——它让命令走 shell，能继承完整 PATH。
cargo run 提示 error: no Cargo.toml file found
根本原因是 working_dir 指向了错误路径。Sublime 默认用 ${file_path}（比如打开 src/main.rs 时是 src/ 目录），但 cargo run 必须在含 Cargo.toml 的项目根目录下运行。
Build System 中必须写：
"working_dir": "${project_path:${folder}}"
而不是 ${file_path} 或留空。
同时确认你打开的是整个项目文件夹：
- 用 File → Open Folder 加载含
Cargo.toml的目录，别只双击单个.rs文件 - 右键标签页 → Reveal in Side Bar，看侧边栏是否显示项目根目录层级
如果只是临时跑单文件（如 hello.rs），别用 cargo run，改用 rustc hello.rs && ./hello。
构建输出错误但双击不跳转到源码行
说明 file_regex 没配或格式错。Rust 编译错误典型格式是：
src/main.rs:2:5: error[E0308]: mismatched types
对应正则应为：
"file_regex": "^(.+):([0-9]+):([0-9]+):\s*(.*)$"
注意两点：
- 反斜杠要双写（JSON 字符串内），
s*写成s*就失效 - 漏掉这行，所有错误都变成纯文本日志，失去可操作性
如果你用的是自定义构建命令（比如带 --quiet 或 --message-format=json），那正则也要同步调整，否则匹配失败。
runt-analyzer 启动失败，报 client not started
这不是插件没装好，是 LSP 插件根本找不到可执行文件。2026 年起 cargo install rust-analyzer 已废弃，rustup component add rust-analyzer 在 macOS 和部分 Linux 上常静默失败。
必须手动下载二进制：
- 去 GitHub Releases 下对应平台的最新版（如
rust-analyzer-aarch64-apple-darwin） - 解压后得到无后缀可执行文件（macOS/Linux）或
.exe（Windows） - 放进固定路径：
/usr/local/bin/rust-analyzer（macOS/Linux）或C: ools ust-analyzer.exe（Windows） - LSP 配置中
"command"必须写绝对路径：["/usr/local/bin/rust-analyzer"]，不能只写["rust-analyzer"]
最后再确认 Sublime 控制台里 import os; print(os.environ.get('PATH')) 输出含该路径——否则即使放对位置，也找不到。
