Rust / 系统课时

安装 Rust 工具链

安装 Rust 工具链

本课使用 rustup 安装并管理稳定版 Rust,同时验证编译器 rustc、构建工具 cargo 和工具链管理器 rustup。完成后,你将拥有一个可更新、可切换版本并能直接创建项目的标准开发环境。

学习目标

  • 使用 rustup 安装稳定版 Rust
  • 识别 rustc、cargo 与 rustup 的职责
  • 通过版本检查和示例项目验证安装结果

安装前检查

准备一个可访问互联网的终端,并确认当前账户有权限写入用户目录。若系统中曾通过 apt、Homebrew 或其他包管理器安装 Rust,建议先确认旧版本来源,避免 PATH 同时指向两套工具链。

rustup 负责安装和切换工具链;rustc 是编译器;cargo 负责创建项目、管理依赖、构建和运行程序。正常情况下,这三个命令会一起进入用户目录下的 Cargo 可执行文件路径。

使用 rustup 安装

在 macOS 或 Linux 终端执行官方安装脚本:

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

预期结果如下,安装器提示文字可能随版本调整:

text
<INSTALL_MENU>
Rust is installed now. Great!

选择默认安装后,关闭并重新打开终端,使 PATH 配置生效。Windows 用户可下载并运行官方 rustup-init.exe,在命令行安装菜单中选择默认选项;安装完成后同样重新打开 PowerShell 或命令提示符。

设置稳定版并检查版本

在新终端中执行以下命令:

bash
rustup default stable
rustc --version
cargo --version
rustup --version

预期输出如下,其中版本号、提交信息、日期和目标平台会随安装时间及操作系统变化:

text
<RUSTUP_DEFAULT_STABLE_MESSAGE>
rustc <VERSION> (<COMMIT_HASH> <DATE>)
cargo <VERSION> (<COMMIT_HASH> <DATE>)
rustup <VERSION> (<COMMIT_HASH> <DATE>)

只要三个版本命令都能返回信息,且默认工具链是 stable,核心工具链就已正确安装。后续可使用 rustup update stable 更新稳定版,但团队项目仍应结合锁定文件和持续集成环境验证兼容性。

创建项目验证环境

用 cargo 创建并运行一个最小项目:

bash
cargo new hello-rust
cd hello-rust
cargo run

预期结果如下,忽略首次构建时的编译日志和不同系统的可执行文件路径:

text
Hello, world!

cargo new 会生成包清单和源码目录,cargo run 会先编译再运行程序。看到 Hello, world! 说明 rustc、cargo、标准库和本机链接环境能够协同工作。

典型失败处理

若提示 command not found 或“无法识别命令”,先重新打开终端,再检查用户目录下的 Cargo 可执行文件路径是否已加入 PATH。不要同时保留多个来源不明的 rustc 路径。

若安装脚本下载失败,优先检查网络、代理、TLS 拦截和系统时间,不要直接关闭证书校验。若构建阶段提示缺少链接器,Linux 通常需要系统 C 编译工具链,Windows 则需要与所选目标匹配的 Microsoft C++ 构建工具。

本课总结

  • rustup 统一管理 Rust 工具链,rustc 负责编译,cargo 负责项目与依赖
  • 安装后必须在新终端中检查三个版本命令
  • 成功运行 cargo 示例项目才算完成端到端验证

下一课预告

下一课将进入 Cargo 项目结构,认识 Cargo.toml、src/main.rs 以及常用的构建和运行命令。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 Rust 工具链

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通