sublime text需通过lsp插件+rust-analyzer实现rust语法检查，核心是确保rust-analyzer二进制已安装、可执行且path正确；lsp配置中command须为数组形式，项目必须在含cargo.toml的目录下打开，调试时优先查看lsp日志。
Sublime Text 本身不内置 Rust 语法检查，必须通过 LSP 插件 + rust-analyzer 语言服务器实现。直接装插件不配置路径或环境，lsp-rust-analyzer 会报 "server crashed" / "command not found" —— 核心问题从来不是插件没装，而是 rust-analyzer 二进制没被找到或没权限运行。
确认 rust-analyzer 已安装且可执行
Sublime 的 LSP 插件不会自动下载 rust-analyzer，必须手动安装并确保终端能调用：
- 运行
rustup component add rust-analyzer（推荐方式，版本与 toolchain 同步） - 或从 GitHub Releases 下载对应平台的
rust-analyzer二进制，重命名为rust-analyzer，放入/usr/local/bin（macOS/Linux）或%USERPROFILE%\bin（Windows）并加入PATH - 在终端执行
rust-analyzer --version，有输出才说明可用；若提示Permission denied（Linux/macOS），需chmod +x该文件
安装并配置 LSP 插件
仅装 LSP 插件不够，还需启用 rust-analyzer 作为 Rust 语言服务器：
- 用 Package Control 安装
LSP（不是 “LSP-rust-analyzer” —— 这个是旧/废弃包） - 打开
Preferences → Package Settings → LSP → Settings，在用户设置中写入：
{
"clients": {
"rust-analyzer": {
"enabled": true,
"command": ["rust-analyzer"],
"selector": "source.rust",
"initializationOptions": {
"cargo": {
"loadOutDirsFromCheck": true
},
"procMacro": {
"enable": true
}
}
}
}
}
注意："command" 值必须是数组形式；如果 rust-analyzer 不在 PATH 中，这里要写绝对路径，例如 ["/home/you/.cargo/bin/rust-analyzer"]。
确保 Sublime 能读取 Cargo 工作区
rust-analyzer 需要识别 Cargo.toml 才能加载依赖和宏，常见失效场景：
- 打开的是单个
.rs文件，而非整个 crate 目录（即没在包含Cargo.toml的文件夹里右键 →Open Folder） - 项目使用 workspace，但根目录没有
Cargo.toml（此时需在 workspace 子 crate 目录下打开） -
target目录被误删或cargo check没跑过，rust-analyzer可能卡在“loading”状态 —— 手动执行一次cargo check再重启 Sublime
调试 LSP 连接失败的典型现象
如果保存后无错误提示、跳转无效、hover 不显示类型，先看 LSP 控制台：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入LSP: Toggle Log Panel打开日志 - 常见错误：
-
"Failed to start server: command 'rust-analyzer' not found"→ 检查PATH或command路径 -
"server process exited with code 1"→ 多半是rust-analyzer二进制损坏或架构不匹配（如 M1 Mac 装了 x86 版） - 日志里反复出现
"project root not found"→ 当前视图未关联到含Cargo.toml的目录
-
真正麻烦的永远不是配置步骤，而是 Sublime 启动时继承的 PATH 和 shell 环境不一致 —— 尤其 macOS GUI 应用默认不读 ~/.zshrc，得靠 launchctl setenv PATH ... 或改用 subl . 从终端启动。
