Rust 环境配置：Rustup 安装与配置

下载并运行官方安装脚本
打开终端（Linux/macOS）或 PowerShell（Windows），执行以下命令：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

该命令会自动下载 rustup 安装程序并启动交互式安装流程。

选择安装选项
安装脚本启动后，会提示选择安装模式：

1. 输入 1 并按回车，选择默认安装（推荐大多数用户）。
   此选项会安装最新稳定版的 Rust 工具链，包括 rustc（编译器）、cargo（包管理器）和 rustdoc（文档生成器）。
2. 如需自定义安装路径或组件，可输入 2 进入高级模式，但新手无需操作。

配置环境变量
安装完成后，rustup 会自动将 Rust 的二进制目录添加到 shell 的 PATH 环境变量中。

• Linux/macOS 用户：脚本会修改 ~/.bashrc、~/.zshrc 或其他当前 shell 的配置文件。
  重新加载配置：执行 source "$HOME/.cargo/env"` 使环境变量立即生效。 - **Windows 用户**：安装程序会自动更新系统 `PATH`。 **重启终端**：关闭并重新打开 PowerShell 或 CMD 窗口以应用更改。 --- **验证安装结果** **运行以下命令检查 Rust 是否正确安装**： ```bash rustc --version ``` 正常输出应类似： ``` rustc 1.78.0 (xxxxx 2024-xx-xx) ``` **同时验证 Cargo 是否可用**： ```bash cargo --version ``` 输出应显示 Cargo 版本号，例如： ``` cargo 1.78.0 (xxxxx 2024-xx-xx) ``` --- **管理 Rust 工具链** `rustup` 允许安装和切换多个 Rust 版本（称为“工具链”）。常用操作如下： 1. **列出已安装的工具链**： ```bash rustup toolchain list ``` 2. **安装其他工具链**（如 nightly 或 beta 版本）： ```bash rustup install nightly ``` 3. **设置默认工具链**： ```bash rustup default stable ``` 将 `stable` 替换为 `nightly` 或 `beta` 可切换默认版本。 4. **为特定项目指定工具链**： 在项目根目录下创建 `rust-toolchain.toml` 文件，内容示例： ```toml [toolchain] channel = "1.75.0" ``` 下次在该项目中运行 `cargo` 命令时，会自动使用指定版本。 --- **更新 Rust 工具链** **定期执行以下命令保持 Rust 最新**： ```bash rustup update ``` 该命令会： - 更新 `rustup` 自身 - 更新所有已安装的工具链（如 stable、nightly） - 清理旧版本缓存以节省磁盘空间 --- **卸载 Rust** 如需完全移除 Rust 环境： 1. **运行卸载命令**： ```bash rustup self uninstall ``` 2. **手动清理残留**（可选）： 删除 `~/.cargo` 和 `~/.rustup` 目录（Linux/macOS）或 `%USERPROFILE%\.cargo` 与 `%USERPROFILE%\.rustup`（Windows）。 --- **配置国内镜像加速（可选）** 在中国大陆，官方源下载可能较慢。可通过环境变量配置镜像： 1. **设置 Cargo 镜像**： 创建或编辑 `~/.cargo/config.toml`（Linux/macOS）或 `%USERPROFILE%\.cargo\config.toml`（Windows），添加： ```toml [source.crates-io] replace-with = 'rsproxy-sparse' [source.rsproxy-sparse] registry = "sparse+https://rsproxy.cn/index/" [registries.rsproxy] index = "https://rsproxy.cn/git/crates.io-index.git" [net] git-fetch-with-cli = true ``` 2. **设置 rustup 镜像**： 执行以下命令： ```bash rustup set proxy https://rsproxy.cn ``` --- **常见问题排查** | 问题现象 | 解决方案 | | :--- | :--- | | 执行 `rustc` 提示“command not found” | **检查 PATH 是否包含 `$HOME/.cargo/bin（Linux/macOS）或 %USERPROFILE%\.cargo\bin（Windows）。若缺失，手动添加并重启终端。 |
  | rustup update 报网络错误 | 确认是否配置了代理或防火墙限制。若在国内，优先配置上述镜像源。 |
  | 多版本工具链冲突 | 使用 rustup override set <toolchain> 在项目目录锁定版本**，避免全局切换影响其他项目。 |

安装 IDE 支持（可选但推荐）

1. 安装 rust-analyzer：
   大多数编辑器（VS Code、Vim、Emacs 等）通过插件调用 rust-analyzer 提供智能提示。
   VS Code 用户：在扩展商店搜索 “rust-analyzer” 并安装官方插件。
2. 验证语言服务器：
   打开 .rs 文件后，状态栏应显示 “rust-analyzer: ready”。若未启动，检查 rustup component list 是否包含 rust-analyzer-preview（通常自动安装）。