sublime text 的 rust 支持需手动配置工具链和插件:必须安装 rustup、cargo 和 rust-analyzer,启用 rustenhanced 插件的 lsp 功能并正确设置路径,同时确保项目根目录被识别以实现完整功能。

Sublime Text 本身不内置 Rust 支持,所有 Rust 相关功能都依赖第三方插件和外部工具链配合。如果你刚从 VSCode 切过来,会明显感觉 Sublime Text 的 Rust 配置更“手动”、更底层——它不提供开箱即用的智能提示或调试器集成,而是靠你把 rustup、cargo、racer(或 rust-analyzer)这些组件串起来。
Sublime Text 要跑 Rust,先得有 rustup 和 cargo
这是最容易被忽略的前提。很多用户装完 Sublime Text 插件后发现没提示、没跳转、编译报错,第一反应是插件坏了,其实只是 rustc 根本没装,或者 cargo 不在 PATH 里。
验证方法很简单:在终端里运行 cargo --version 和 rustc --version,两个都得能正常输出。如果不行,别急着配编辑器,先去官网装 rustup,再执行 rustup install stable 和 rustup default stable。
Rust 插件选 RustEnhanced 还是 sublime-rust?
目前主流选择是 RustEnhanced(GitHub 上活跃维护),它支持:
• 基于 cargo 的构建/测试/运行(Ctrl+B 默认调 cargo build)
• racer 或 rust-analyzer 后端的自动补全与跳转(需额外安装并配置路径)
• rls 已废弃,别再折腾;rust-analyzer 是当前推荐的 LSP 后端
• sublime-rust 更轻量但功能收敛,只做语法高亮+基础构建,适合纯查看代码场景
为什么装了 RustEnhanced 还是没代码提示?
因为默认不启用 LSP 功能,且不会自动找 racer 或 rust-analyzer。你需要:
• 手动安装 rust-analyzer:运行 rustup component add rust-analyzer
• 在 Sublime Text 里打开 Preferences → Package Settings → RustEnhanced → Settings
• 把 "use_lsp": true 设为 true,并确认 "lsp_binary_path" 指向正确的 rust-analyzer 可执行文件(Linux/macOS 通常是 ~/.cargo/bin/rust-analyzer,Windows 是 %USERPROFILE%\.cargo\bin\rust-analyzer.exe)
• 重启 Sublime Text,打开一个 .rs 文件,状态栏右下角应显示 “Rust (LSP)”
编译错误不内联显示?检查构建系统是否识别 cargo.toml
RustEnhanced 的默认构建系统会尝试在当前文件所在目录向上查找 cargo.toml,找不到就 fallback 到 cargo build。常见问题:
• 你在子目录打开单个 .rs 文件(比如 src/main.rs),但构建系统没找到项目根目录的 cargo.toml,于是报错 “no project found”
• 解决办法:用 Ctrl+Shift+P → “Rust: Set Cargo Project Root”,手动指定包含 cargo.toml 的目录
• 或者直接用 Ctrl+Shift+P → “Rust: Build Project”,它会主动搜索整个工作区
cargo 是否可用、rust-analyzer 是否可执行、路径是否写对、项目根是否被识别——这三者只要一个断掉,整个 Rust 支持就退化成纯语法高亮。











