Sublime Text 配置 Rust 环境必须同时满足三条件：rustc/cargo 在终端和 Sublime 中均可调用、文件语法手动设为 Rust、rust-analyzer 与 rustfmt 均用绝对路径显式配置；缺一则补全、格式化、跳转等功能静默失效。
想用 Sublime Text 写 Rust 代码？有个关键事实得先认清：Sublime 本身对 Rust 是“零支持”的。所有智能功能——代码补全、格式化、定义跳转——都依赖外部工具。这就意味着，整个环境能否跑起来，完全取决于三件事：外部命令能不能被正确调用、文件语法有没有被正确识别、关键工具的路径有没有写对。这三者环环相扣，缺了任何一个，功能都会“静默失效”。什么叫静默失效？就是编辑器不会给你报红字错误，但你会发现按 Ctrl+B 没反应、保存文件不自动格式化、跳转功能是灰的、右下角状态栏永远显示着“Plain Text”。问题就藏在这些细节里。
rustc 和 cargo 必须在终端和 Sublime 里都可用
这可不是简单的“装了就行”，而是一个硬门槛。很多朋友在终端里敲 cargo --version 明明有输出，但一回到 Sublime，构建系统就找不到命令了。这种情况在 macOS 从 Dock 启动 Sublime，或者 Windows 用户修改环境变量后没有彻底重启编辑器时，尤其常见。
- 首先，打开你的系统终端，逐行执行：
cargo --version和rustc --version。两个命令都必须有版本信息输出。 - macOS 或 Linux 用户：请确认
~/.cargo/bin这个路径已经添加到了你 shell 的$PATH环境变量中，并且执行过rustup default stable来设置默认工具链。 - Windows 用户：重点检查系统环境变量，确保包含了
%USERPROFILE%\.cargo\bin。添加完成后，必须彻底关闭并重新启动 Sublime Text（不仅仅是关掉窗口），新的环境变量才会生效。 - 最后，在 Sublime 内部验证：打开 Sublime 的控制台（快捷键
Ctrl+`），输入import os; print(os.environ.get('PATH'))，看看打印出的路径列表里，是否包含.cargo/bin。
Rust 语法高亮不生效？不是插件没装，是语法没选对
这里有个普遍的误解：Sublime 不会自动把 .rs 后缀的文件当作 Rust 代码来处理。它完全依赖右下角状态栏的那个语法标识（比如显示“Plain Text”还是“Rust”）来决定是否启用构建、高亮、补全等一系列能力。这个标识一旦错了，后面所有配置都是白搭。
- 打开任意一个
.rs文件，首先看一眼右下角状态栏，显示的是不是Rust？如果不是，点击它，然后在弹出的列表里选择Rust。 - 如果列表里压根就没有
Rust这个选项，那说明官方的 Rust 语法插件没有加载。你需要通过 Package Control 安装名为Rust（作者是 rust-lang）的插件。注意，不要安装那个叫RustEnhanced的，两者会冲突。 - 安装完成后，通过菜单
View → Syntax → Rust → Rust将其设为默认语法，这样就省得每次手动切换了。 - 顺便检查一下，如果系统里还残留着旧版的
Rust插件，建议禁用或卸载。它已经停止维护，可能会干扰新插件的语法识别。
rustfmt 保存自动格式化失效？路径不能写 ~，也不能依赖 $PATH
无论是 RustEnhanced 插件还是 LSP，它们都有一个共同点：不解析波浪号 ~（代表用户家目录），也不读取你 shell 的 $PATH 环境变量。如果把路径写错了，保存文件时会完全没反应，控制台里甚至不会报错——只有你主动打开控制台（Ctrl+`），才有可能看到一行 rustfmt: command not found 的提示。
- 第一步，先确认
rustfmt已经安装。执行cargo install rustfmt（注意，Rust 1.75 版本之后，rustfmt不再默认附带）。 - 第二步，查找它的真实绝对路径。在终端执行
which rustfmt（Linux/macOS）或where rustfmt（Windows）。 - 第三步，打开 Sublime 的
Preferences → Package Settings → RustEnhanced → Settings，在设置文件中填写绝对路径："rustfmt_path": "/home/username/.cargo/bin/rustfmt"（Linux/macOS 示例）"rustfmt_path": "C:\Users\username\.cargo\bin\rustfmt.exe"（Windows 示例） - 记住，绝对不要写成
~/.cargo/bin/rustfmt，Sublime 看不懂这个缩写。
rust-analyzer 连不上？它不能 cargo install，也不能靠 rustup component add 全平台生效
rust-analyzer 是一个独立的二进制语言服务器，它并不是 Rust 工具链的标准组件。这里有两个历史坑点：cargo install rust-analyzer 这个安装命令早已废弃；而 rustup component add rust-analyzer 在 macOS 和部分 Linux 发行版上，经常会因为权限或系统架构问题而安装失败。
- 最可靠的方法是，直接去 GitHub 的 rust-lang/rust-analyzer 仓库的 Releases 页面，下载对应你操作系统的最新压缩包（比如
rust-analyzer-x86_64-unknown-linux-gnu.gz）。 - 解压后，你会得到一个没有后缀的可执行文件（在 Windows 下是
rust-analyzer.exe）。 - 把它放到一个全局可执行的位置，例如：
/usr/local/bin/rust-analyzer（Linux/macOS）或%USERPROFILE%\.cargo\bin\rust-analyzer.exe（Windows）。 - 然后，在
RustEnhanced或LSP的配置中，用绝对路径明确指定它："rust_analyzer_path": "/usr/local/bin/rust-analyzer"。 - 首次启用时，需要耐心等待它完成项目索引。小项目几秒钟，大项目可能需要几十秒。在此期间，跳转、补全等功能都不可用，这属于正常现象，并不是配置挂了。
最后，有两点最容易让人栽跟头，却常常被忽略：第一，Sublime Text 的启动方式（比如是从终端启动还是从图形界面启动）会直接影响它继承哪些环境变量；第二，rust-analyzer 在索引完成之前，所有基于语义的智能功能都是不可用的。如果不提前了解这两点，你很可能会浪费大量时间去怀疑是不是插件装错了，或者配置写错了。
