安装 Rust 工具链

要写 Rust，你其实只需要装一个东西：rustup。它是 Rust 的官方工具链安装器和管理器。装好 rustup 之后，编译器、包管理器这些东西会一起被带下来，不用你一个个单独装。

2-1 工具链里都有谁

初学者最容易迷糊的就是分不清 rustup、rustc、cargo 这三个名字。一句话区分：

• rustup：安装和管理工具链的”总管”。你基本只在切换版本时才直接碰它。
• rustc：Rust 编译器。它负责把你写的 .rs 源文件编译成可执行程序。平时你很少直接敲 rustc，都是让 cargo 替你调。
• cargo：构建工具和包管理器。创建项目、编译、运行、下载别人写的库（在 Rust 里叫 crate），全靠它。你 90% 的时间都在跟 cargo 打交道。

本教程基于 Rust 1.97.1、2024 Edition。rustup 安装时默认会拉取当时最新的稳定版，版本号可能比这略新，这没问题——Rust 向后兼容，新版本照样能跑本教程所有示例。

2-2 Windows 上安装

Windows 用户有两种走法。

第一种，用官方安装脚本。打开浏览器访问 https://www.rust-lang.org/tools/install ，页面会引导你。但因为 Rust 依赖 C 语言链接工具链，Windows 上它还需要一个叫 MSVC 生成工具 的环境。最简单的方式是先从 https://visualstudio.microsoft.com/ 下载并安装 “Visual Studio 生成工具”，勾选”使用 C++ 的桌面开发”工作负载，装好后再跑 rustup 安装程序。

第二种，更省事：装一个 Visual Studio Code 搭配 Dev Containers，或者直接装 WSL（Windows 子系统 Linux），在 Linux 环境里按下面的 Linux 步骤装。很多 Windows 上的 Rust 开发者最终都选了 WSL，因为命令行体验更接近原汁原味的类 Unix 环境。

2-3 macOS 与 Linux 上安装

这两个系统装起来最干净。打开终端，执行官方安装命令：

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

脚本会问你安装方式，直接回车选默认（1）即可。它会在 ~/.cargo/bin 目录下放好 rustc、cargo、rustup，并自动把这条路径写进你的 shell 配置文件（.zshrc 或 .bashrc）。

装完之后，关掉当前终端重新打开一个，让环境变量生效。如果你用某些精简版 shell 没自动生效，可以手动执行：

source "$HOME/.cargo/env"

2-4 验证安装是否成功

无论哪个平台，装完后都跑下面两条命令确认：

rustc --version
cargo --version

如果顺利，你会看到类似这样的输出：

rustc 1.97.1 (xxxxxx 2026-08-01)
cargo 1.97.1 (xxxxxx 2026-08-01)

版本号不一定精确到 1.97.1，只要能打印出来、且没有”command not found”，就说明装好了。看到这两行字，恭喜你，工具链已经就位。

2-5 顺手装个代码编辑器

编译器有了，你还需要一个写代码的编辑器。强烈推荐 Visual Studio Code（免费），再装上官方 Rust 扩展 rust-analyzer。它会给你实时的报错提示、自动补全、跳转到定义，写 Rust 体验提升一大截。

不想折腾的话，记事本也能写，但你会失去”边写边发现错误”的反馈，学习效率低很多，不推荐。

2-6 更新与卸载（备用知识）

工具链以后要升级，一条命令：

rustup update

想卸载，rustup 也提供了干净卸载：

rustup self uninstall

这两条你暂时用不上，先有个印象即可。下一章会专门讲 rustup 怎么管理多个版本和工具链，这一章只要保证”能装、能验证”就达标了。

2-7 常见安装问题速查

• 网络慢/下载卡住：rustup 默认从官方源下载。国内网络有时较慢，可以搜索”rustup 镜像”配置清华或中科大镜像源加速，本质是在装之前设置 RUSTUP_DIST_SERVER 环境变量。
• 权限报错：Linux/macOS 不要用 sudo 跑那条 curl 安装脚本，rustup 设计就是装到用户目录，加 sudo 反而会带来权限混乱。
• 公司代理环境：若处于代理后，需先设置 HTTP_PROXY / HTTPS_PROXY 环境变量再执行安装。

装好之后，下一章我们直接用 rustup 管理版本，再之后就让 cargo 帮你生出第一个项目。先把这一章的验证命令跑通，别急着往前赶。

2-8 Windows 上 MSVC 与 GNU 工具链的差异

在 Windows 上装 Rust，还有一个选择你迟早会碰到：用 MSVC 还是 GNU 工具链。装 rustup 时它会问你默认用哪个。绝大多数情况选默认的 MSVC（需要前面说的 Visual Studio 生成工具提供链接器）。MSVC 是 Windows 官方编译器后端，编出来的程序在 Windows 上兼容性最好、不需要额外装运行时。

另一个选项是 GNU（基于 MinGW 的 GCC 工具链）。选它的好处是你不用装庞大的 Visual Studio，只需装一个轻量的 MinGW 环境。但编出来的程序在没装 MinGW 的机器上可能要带一个运行库，且某些 Windows 专属 API 支持不如 MSVC 全。

2-9 其它验证命令

除了 rustc --version 和 cargo --version，还有几个命令能帮你确认环境：

rustup --version   # 确认 rustup 自身装好
cargo --list       # 列出 cargo 所有可用子命令

如果在任意目录都能跑这些命令，说明 PATH 已正确配置。Windows 上若提示”不是内部或外部命令”，多半是安装时没勾选”添加到 PATH”，重装时勾上、或手动把 %USERPROFILE%\.cargo\bin 加进系统环境变量即可。

2-10 小结

安装这章的目标很单纯：让工具链就位并能验证。Windows 上默认选 MSVC，Linux/macOS 一条命令搞定；装好 rustc 和 cargo 两个命令能出版本号就达标。rustup 负责管版本与组件，后面章节会反复用到它。下一章正式写第一个程序。