sublime text 配置 rust 开发环境本质是确保 cargo/rustc 可调用、.rs 文件识别为 rust、错误可跳转、lsp 连通 rust-analyzer；缺一即 ctrl+b 静默失败或功能半残。

Sublime Text 本身不编译 Rust，所谓“配置 Rust 开发环境”，本质是让 cargo 和 rustc 在 Sublime 内部能被调用、.rs 文件被识别为 Rust、错误能双击跳转、LSP 补全能连上 rust-analyzer——四者缺一，Ctrl+B 就静默失败或功能半残。

Sublime 控制台里 cargo --version 调不通？先别装插件

终端里能跑不等于 Sublime 能跑。Sublime 启动时读的是自己的环境变量，和 shell 配置无关。

• 按 Ctrl+` 打开 Sublime 控制台，执行：
  

  import os; print(os.environ.get('PATH'))

  确认输出中包含 .cargo/bin（如 /Users/xxx/.cargo/bin 或 C:\Users\xxx\.cargo\bin）
• Windows：必须把 %USERPROFILE%\.cargo\bin 加进「系统环境变量」（不是用户变量），加完后在任务管理器里彻底杀掉所有 subl.exe 进程，再重开
• macOS/Linux：GUI 启动的 Sublime 不加载 ~/.zshrc，即使你写了 export PATH="$HOME/.cargo/bin:$PATH" 也无效；推荐从终端执行 subl 启动编辑器，或改用绝对路径启动
• 验证失败？重装 rustup：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh，再运行 rustup default stable

右下角显示 Plain Text？语法没设对，后面全白搭

Sublime 不会自动把 .rs 文件当 Rust 处理。状态栏不是 Rust，构建系统、LSP、格式化全部失效——这不是 bug，是 selector 匹配机制在起作用。

Sublime Text Build Linux版

Sublime Text Linux x86-64 deb 安装包。官方也提供 rpm、tar.xz 和软件源安装方式。

下载

• 打开任意 .rs 文件，点右下角状态栏（显示 Plain Text 的地方），手动选 Rust
• 如果列表里没有 Rust，说明插件没加载：用 Package Control 安装 Rust（by rust-lang），不要装 RustEnhanced——二者共存会导致高亮错乱、构建失败
• 装完后进 View → Syntax → Rust → Rust，设为默认，避免每次手动切
• 检查设置里 syntaxes 是否为 "Packages/Rust/Rust.sublime-syntax"，大小写、路径错一个字符都不匹配

构建系统报 No build system 或 no Cargo.toml found？字段漏了或路径错了

网上抄的 JSON 常漏关键字段，导致 cargo 找不到项目根目录，或错误无法跳转。

• 构建系统必须同时配对 shell_cmd、working_dir 和 file_regex，三者缺一不可
• 用 "shell_cmd": "cargo run"，别用 "cmd"：前者走系统 shell，能复用 PATH 和别名；后者直调进程，Windows 上空格路径大概率崩
• "working_dir": "${project_path:${folder}}" 必须写：否则 cargo 在当前文件目录执行，找不到项目根下的 Cargo.toml，直接报 no Cargo.toml found
• "file_regex": "^(.+?):([0-9]+):([0-9]+):.*$" 是标准写法；旧正则带 \s*(.*)$ 容易因 cargo 新版错误末尾无空格而失配

LSP 补全永远为空？rust-analyzer 路径和初始化参数没配对

仅装插件无效。cargo install rust-analyzer 已废弃，它只放 stub，LSP 启动时直接报 spawn ENOENT。

• 必须去 rust-lang/rust-analyzer/releases 下载对应平台压缩包（如 rust-analyzer-x86_64-pc-windows-msvc.zip），解压后得到单个可执行文件
• Windows 路径含空格（如 C:\Users\John Doe\）会导致启动失败，建议复制到不含空格路径，如 C:/Users/you/bin/rust-analyzer.exe
• 在 Preferences → Package Settings → LSP → Settings 中写死绝对路径：
  "command": ["C:/Users/you/bin/rust-analyzer.exe"]（不能用 ~，不能相对路径）
• 必须配 initializationOptions，否则 cargo workspace 识别失败、宏展开不补全：
  

  {
    "procMacro.enable": true,
    "languageId": "rust",
    "syntaxes": ["Packages/Rust/Rust.sublime-syntax"]
  }

最容易被忽略的是：Sublime 的 PATH 继承行为与 GUI 启动方式强绑定，Windows 用户常以为加了用户变量就万事大吉，macOS 用户常以为 source ~/.zshrc 后重启 Sublime 就生效——其实都不够。真正起效的，只有彻底退出进程后重新加载的那一次环境变量。