必须先安装 Rust 工具链(rustc、cargo),再下载 rust-analyzer 二进制并加入 PATH,然后在 Sublime 中安装 LSP 插件并正确配置其 command 和 initializationOptions 才能启用 Rust 语言支持。

确认系统已安装 Rust 工具链
没装 rustc 和 cargo,装再多个插件也跑不起来。打开终端执行:
rustc --version cargo --version
如果报 “command not found”,先去 rustup.rs 下载安装 rustup,它会自动把 rustc、cargo、cargo-clippy 等加进 PATH。Windows 用户注意:别用 MSYS2 或 Chocolatey 装的旧版 Rust,容易和 rust-analyzer 的二进制不兼容。
安装 rust-analyzer 服务二进制
rust-analyzer 不是 Sublime 插件本身,而是一个独立的 LSP 服务器,Sublime 需要调用它的可执行文件。不能靠 Package Control 直接装完就用。
- 去 GitHub releases 页面 下载最新
rust-analyzer-x86_64-pc-windows-msvc.zip(Windows)、rust-analyzer-x86_64-unknown-linux-gnu.gz(Linux)或rust-analyzer-aarch64-apple-darwin.gz(M1/M2 Mac) -
解压后得到单个可执行文件
rust-analyzer(无后缀),重命名为rust-analyzer.exe(Windows)或保持原名(macOS/Linux) - 把它放到一个固定路径,比如
$HOME/.local/bin/rust-analyzer(Linux/macOS)或%USERPROFILE%\bin\rust-analyzer.exe(Windows),并确保该路径在系统PATH中
验证是否可用:
rust-analyzer --version
在 Sublime Text 中安装 LSP 插件并配置 rust-analyzer
Sublime 本身不内置 LSP 支持,必须通过第三方插件桥接。推荐用官方维护的 LSP 插件(不是 LSP-rust-analyzer 这类过时封装)。
- 用 Package Control 安装
LSP(作者:sublimelsp) - 重启 Sublime,按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入LSP: Enable Language Server Globally,选中rust - 接着执行
LSP: Settings,在用户设置里补全以下内容:
{
"clients":
{
"rust-analyzer":
{
"enabled": true,
"command": ["rust-analyzer"],
"selector": "source.rust",
"initializationOptions": {
"cargo": {
"loadOutDirsFromCheck": true
},
"procMacro": {
"enable": true
}
}
}
}
}
关键点:"command" 必须能被 Shell 找到——如果没加进 PATH,就写绝对路径,例如 ["/home/you/.local/bin/rust-analyzer"]。Mac 用户若用 zsh,Sublime 可能读不到 shell 的 PATH,这时必须写死路径。
验证与常见失败信号
打开一个 .rs 文件,看窗口右下角是否显示 rust-analyzer。如果没有,打开 Ctrl+` 控制台,搜 LSP 或 rust-analyzer 关键字,常见错误有:
-
server crashed: exit status 1→ 二进制权限不对(Linux/macOS 没chmod +x)或架构不匹配(比如在 M1 上用了 x86_64 版) -
connection closed before response→rust-analyzer启动卡住,多半是项目根目录下没有Cargo.toml,或当前文件不在 cargo workspace 内 - 有提示但无跳转/无补全 → 检查
selector是否为"source.rust"(旧版 Sublime Rust 插件可能设成"source.rust++",冲突)
真正起作用的永远是 rust-analyzer 二进制本身,不是 Sublime 插件包装层。任何功能异常,第一反应不是重装插件,而是手动在终端跑一遍 rust-analyzer --version 和 rust-analyzer -h,确认它能独立运行。










