Sublime Text 需通过 RustEnhanced 插件支持 Rust,关键配置包括:确认已安装 cargo/rustc 并加入 PATH;显式设置 rust.cargo_path 为绝对路径;禁用冲突的 LSP-Rust 以避免卡顿;启用 racer 补全并确保其正确安装。

Sublime Text 本身不原生支持 Rust,必须靠插件补足语法高亮、代码补全、错误检查和构建能力;直接装 RustEnhanced 就够用,但默认配置容易卡顿或报错,关键在关掉冗余 LSP 和调对 cargo 路径。
安装 RustEnhanced 插件前先确认基础依赖
它不是独立运行的,依赖系统已安装的 Rust 工具链:cargo、rustc、rustup。如果 cargo --version 在终端报错,插件会反复提示 “cargo not found”。Windows 用户尤其注意 PATH 是否包含 %USERPROFILE%\.cargo\bin;macOS/Linux 用户若用 rustup install 安装,通常没问题,但用 Homebrew 装的 rust 包不含 cargo,得重装。
- 运行
cargo --version和rustc --version确认两者都可执行 - 检查
cargo所在路径是否在 Sublime 的环境变量中(可通过subl -w启动时继承 shell PATH,或手动设PATH) - 不要同时启用
RustEnhanced和sublime-rust—— 二者冲突,后者已停止维护
配置 rust.cargo_path 防止构建失败
插件默认调用 cargo 命令,但 Sublime 在 GUI 启动时可能读不到 shell 的 PATH,导致构建时提示 "cargo" is not recognized 或 No such file or directory。必须显式指定路径。
- 打开 Sublime →
Preferences → Package Settings → RustEnhanced → Settings - 在用户设置里加一行:
"rust.cargo_path": "/Users/xxx/.cargo/bin/cargo"(macOS/Linux)或"rust.cargo_path": "C:\\Users\\xxx\\.cargo\\bin\\cargo.exe"(Windows) - 路径必须是
cargo可执行文件的**绝对路径**,不能写cargo或~/.cargo/bin/cargo - 改完保存,重启 Sublime,再用
Ctrl+Shift+B(Windows/Linux)或Cmd+Shift+B(macOS)测试构建
禁用内置 LSP 避免 CPU 占用飙升
RustEnhanced 自带基于 racer 的补全,但新版默认也启用了 Sublime 自带的 LSP 插件(如果已安装),两者叠加会导致 racer 进程反复 fork、CPU 持续 100%、光标卡死。这不是 Rust 项目大,是 LSP 和 RustEnhanced 的 language server 冲突。
- 如果已装
LSP插件,打开其设置:Preferences → Package Settings → LSP → Settings - 加入
"disabled_packages": ["RustEnhanced"]—— 不,这是错的;正确做法是在 LSP 设置里把rust从clients中移除,或直接删掉LSP-rust子包 - 或者更干脆:在 RustEnhanced 设置中设
"rust.racer_completion_enabled": true,并确保"rust.rustfmt_on_save": false(rustfmt易超时) - 验证方式:打开
.rs文件,输入std::,看是否弹出补全;没反应就检查racer是否安装:cargo install racer
真正麻烦的不是装不上,而是 cargo_path 写错、LSP 多开、racer 没装这三件事凑一起——看起来像插件坏了,其实只是配置没对齐。Mac M1/M2 用户还要额外确认 racer 是用 aarch64-apple-darwin 编译的,否则运行时报 Illegal instruction。










