Rust / 系统课时
安装 Rust 工具链
安装 Rust 工具链
本课使用 rustup 安装并管理稳定版 Rust,同时验证编译器 rustc、构建工具 cargo 和工具链管理器 rustup。完成后,你将拥有一个可更新、可切换版本并能直接创建项目的标准开发环境。
学习目标
- 使用 rustup 安装稳定版 Rust
- 识别 rustc、cargo 与 rustup 的职责
- 通过版本检查和示例项目验证安装结果
安装前检查
准备一个可访问互联网的终端,并确认当前账户有权限写入用户目录。若系统中曾通过 apt、Homebrew 或其他包管理器安装 Rust,建议先确认旧版本来源,避免 PATH 同时指向两套工具链。
rustup 负责安装和切换工具链;rustc 是编译器;cargo 负责创建项目、管理依赖、构建和运行程序。正常情况下,这三个命令会一起进入用户目录下的 Cargo 可执行文件路径。
使用 rustup 安装
在 macOS 或 Linux 终端执行官方安装脚本:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh预期结果如下,安装器提示文字可能随版本调整:
<INSTALL_MENU>
Rust is installed now. Great!选择默认安装后,关闭并重新打开终端,使 PATH 配置生效。Windows 用户可下载并运行官方 rustup-init.exe,在命令行安装菜单中选择默认选项;安装完成后同样重新打开 PowerShell 或命令提示符。
设置稳定版并检查版本
在新终端中执行以下命令:
rustup default stable
rustc --version
cargo --version
rustup --version预期输出如下,其中版本号、提交信息、日期和目标平台会随安装时间及操作系统变化:
<RUSTUP_DEFAULT_STABLE_MESSAGE>
rustc <VERSION> (<COMMIT_HASH> <DATE>)
cargo <VERSION> (<COMMIT_HASH> <DATE>)
rustup <VERSION> (<COMMIT_HASH> <DATE>)只要三个版本命令都能返回信息,且默认工具链是 stable,核心工具链就已正确安装。后续可使用 rustup update stable 更新稳定版,但团队项目仍应结合锁定文件和持续集成环境验证兼容性。
创建项目验证环境
用 cargo 创建并运行一个最小项目:
cargo new hello-rust
cd hello-rust
cargo run预期结果如下,忽略首次构建时的编译日志和不同系统的可执行文件路径:
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 以及常用的构建和运行命令。