Sublime Text 运行 Rust 依赖本地工具链，必须先验证 rustc 和 cargo 可用；推荐 RustEnhanced 插件并手动配置 rust-analyzer 路径；自定义构建系统需设 shell_cmd、file_regex 和 working_dir，修改后须手动重选构建系统。
Sublime Text 本身不编译 Rust，所有“运行”“格式化”“跳转定义”都依赖你本地是否装对了 cargo、rustc 和 rust-analyzer —— 插件只是管道，工具链才是引擎。没配好工具链，装再多插件也只会静默失效。
验证 rustc 和 cargo 是否真正可用
这是唯一硬门槛，其他步骤全建立在这之上：
- 打开终端（不是 Sublime 控制台），执行
cargo --version和rustc --version，两行都必须输出版本号，不能报 command not found - Windows 用户：rustup 安装后，务必把
C:\Users\XXX\.cargo\bin加进系统 PATH，并重启 Sublime（它不读取新环境变量） - macOS/Linux 用户：如果用
rustup install stable却没执行rustup default stable，cargo可能指向空工具链；用rustup show确认 active toolchain 是 installed 状态 - 常见假成功：iTerm 里能跑，但 Sublime 里 Ctrl+B 报
cargo not found—— 因为 Sublime 启动时没加载 shell 配置（如 ~/.zshrc），PATH 不完整
选对插件：RustEnhanced 而非老版 Rust
Package Control 搜 “Rust” 会出现两个名字接近的插件：
-
Rust（by rust-lang）：只提供基础语法高亮和折叠，不支持 Cargo 工作区、无构建集成，2025 年起已基本停止维护 -
RustEnhanced：当前唯一持续更新、完整对接cargo和rust-analyzer的插件，支持cargo run/test/clippy快捷键（Ctrl+Shift+B / Ctrl+Alt+T / Ctrl+Alt+L） - 装完
RustEnhanced后，务必禁用或卸载老版Rust插件，否则语法高亮会冲突，右下角状态栏可能卡在 Plain Text
rust-analyzer 不是可选，且不能用 cargo install
没有 rust-analyzer，你就只有语法高亮和构建能力，没有类型提示、悬停查看、Go to Definition、重命名重构 —— 这些不是插件功能缺失，是根本没语言服务器响应：
-
cargo install rust-analyzer已废弃，2026 年起所有平台均不可靠；rustup component add rust-analyzer在 macOS 和部分 Linux 发行版上常因权限或架构问题失败 - 正确做法：去 rust-lang/rust-analyzer/releases 下载对应系统的二进制（如
rust-analyzer-x86_64-unknown-linux-gnu），解压后得到单个无后缀可执行文件 - 重命名并放路径：
rust-analyzer（Linux/macOS）或rust-analyzer.exe（Windows），放进$HOME/.cargo/bin或%USERPROFILE%\.cargo\bin，确保终端里能直接运行rust-analyzer --version - 在 Sublime 里打开
Preferences → Package Settings → RustEnhanced → Settings，手动填入绝对路径："rust_analyzer_path": "/home/username/.cargo/bin/rust-analyzer"（注意：Sublime 不展开~）
构建系统别硬套默认配置，关键字段不能漏
自定义 Rust.sublime-build 是最稳的运行方式，尤其适合单文件调试或无 Cargo.toml 的场景：
- 用
shell_cmd而非cmd：例如"shell_cmd": "cargo run --color=always"，能正确继承 shell 环境变量，避免 Windows 上路径空格崩掉 -
file_regex必须写：例如"file_regex": "^(.*?):([0-9]+):([0-9]+):.*$"，否则双击错误行不会跳转到对应位置 -
working_dir推荐用"${project_path:${folder}}"，让 cargo 在项目根目录运行，而不是当前文件所在目录 - 多入口 binary crate？把
"shell_cmd"改成"cargo run --bin myapp"；想跑测试？换成"cargo test"；纯.rs文件无项目结构？直接用"rustc $file -o ${file_base_name}"编译再执行
最容易被忽略的是：Sublime 不会自动重载构建系统配置，改完 Rust.sublime-build 后，必须手动在菜单栏 Tools → Build System 里重新选中它；更隐蔽的问题是，如果右下角状态栏没显示 Rust，selector 就不匹配，Ctrl+B 直接报 “No build system”，连错误都不会出来。
