Rust 官方推荐使用 rustup 来安装和管理 Rust 工具链,它支持在稳定版、测试版和夜间版编译器之间切换,并简化了跨平台编译。

一、安装 Rust(各平台)#

Linux / macOS

打开终端,执行以下命令即可一键安装:

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

安装完成后,执行以下命令使环境变量生效:

source $HOME/.cargo/env

Windows

  1. 访问 Rust 官网:https://www.rust-lang.org/zh-CN/tools/install
  2. 下载 rustup-init.exe 并双击运行
  3. 在安装界面输入 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 工具链简介#

工具说明
rustcRust 编译器,负责将 .rs 源文件编译成可执行文件
cargoRust 的包管理和构建工具,类似 Node.js 的 npm
rustupRust 版本管理工具,可安装或切换不同 Rust 版本

七、开发环境推荐#

推荐使用 VS Code 搭配 rust-analyzer 插件进行 Rust 开发,可以获得代码补全、类型提示、错误检查等良好体验。