Rust 官方推荐使用 rustup 来安装和管理 Rust 工具链,它支持在稳定版、测试版和夜间版编译器之间切换,并简化了跨平台编译。
一、安装 Rust(各平台)#
Linux / macOS
打开终端,执行以下命令即可一键安装:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
安装完成后,执行以下命令使环境变量生效:
source $HOME/.cargo/env
Windows
- 访问 Rust 官网:
https://www.rust-lang.org/zh-CN/tools/install - 下载
rustup-init.exe并双击运行 - 在安装界面输入
1回车,使用默认设置即可
提示: Windows 用户可能还需要安装 VC++ Build Tools(MSVC 后端)或 MinGW-w64(GNU 后端,推荐用于跨平台开发)。
二、验证安装#
安装完成后,重新打开终端,运行以下命令验证:
rustc --version
cargo --version
如果看到类似 rustc 1.91.1 (ed61e7d7e 2025-11-07) 的输出,说明安装成功。
三、配置国内镜像(推荐)#
在国内使用 Rust 时,配置镜像源可以显著提升下载速度。编辑 ~/.cargo/config 文件(Windows 在 %USERPROFILE%\.cargo\config),添加以下内容:
[source.crates-io]
replace-with = 'ustc'
[source.ustc]
registry = "https://mirrors.ustc.edu.cn/crates.io-index"
提示: 也可以使用阿里云镜像:将
registry设置为"https://mirrors.aliyun.com/crates.io-index"。
四、创建并运行第一个项目#
使用 Cargo(Rust 的包管理和构建工具)创建新项目:
cargo new my_project
cd my_project
cargo run
项目结构如下:
my_project/
├── Cargo.toml # 项目配置文件
└── src/
└── main.rs # 源代码
输出 Hello, world! 即表示项目运行成功。
五、常用 Cargo 命令#
| 命令 | 说明 |
|---|---|
cargo new 项目名 | 创建新项目 |
cargo build | 编译项目(debug 模式) |
cargo build --release | 编译项目(release 模式,已优化) |
cargo run | 编译并运行项目 |
cargo check | 快速检查代码是否能编译(不生成可执行文件) |
cargo test | 运行测试 |
cargo doc --open | 生成并打开文档 |
六、Rust 工具链简介#
| 工具 | 说明 |
|---|---|
| rustc | Rust 编译器,负责将 .rs 源文件编译成可执行文件 |
| cargo | Rust 的包管理和构建工具,类似 Node.js 的 npm |
| rustup | Rust 版本管理工具,可安装或切换不同 Rust 版本 |
七、开发环境推荐#
推荐使用 VS Code 搭配 rust-analyzer 插件进行 Rust 开发,可以获得代码补全、类型提示、错误检查等良好体验。