1 / 11

Rust 入门

学习一门新语言的最好方式，是先把环境配置好，然后用一个最小可运行的程序跑通全流程。接下来我们会一起完成三件事：安装 Rust、写出第一个能运行的程序、认识构建与包管理工具 Cargo。

Rust语言

安装 Rust（使用 rustup）

Rust 官方推荐使用 rustup 进行安装与版本管理。不同系统的安装方式略有差异，但流程都很友好。如果你需要图形安装器或想更换安装方式，可前往官方页面查看说明：Rust 安装页面。

完成安装后，一般无需手动配置 PATH。若你想在当前终端会话中立即启用 Rust 环境（而不是重开终端），可以按安装器提示加载环境脚本。若在编译阶段出现“链接器不可用”之类报错，通常是缺少 C/C++ 工具链；按操作系统文档安装一个常见的 C 编译器即可（在 Windows 上通常需要安装 Visual Studio 的 C++ 构建工具）。

命令行书写约定

本书在演示命令时，会用前缀区分“需要输入的命令”：类 Unix 终端中常见 $，PowerShell 中常见 >。这些前缀只是标识，不需要一并输入。

升级与卸载

当你需要升级到最新稳定版时，执行：


rustup update

若确实需要卸载（包括 rustup 本身），可以执行：


rustup self uninstall

快速自检：验证安装是否成功

在终端输入：


rustc --version

如果看到形如 rustc x.y.z (commit yyyy-mm-dd) 的版本信息，说明安装成功。若命令无法识别，优先检查环境变量 PATH 是否包含 Rust 的可执行文件路径；仍有问题时，建议参考官方论坛与社区资源进行排查。

本地文档

安装包自带离线文档，随时可查：


rustup doc

浏览器会打开标准库与工具链文档。遇到标准库类型或函数的用法不确定时，先查文档几乎总能找到答案。

第一个 Rust 程序

我们先为练习代码准备一个目录，再创建源文件。目录名称自由选择，只要你记得路径即可。示例中，我们新建一个 rust_project 文件夹，并在其中创建子目录 hello_rust，随后编写一个最小程序 main.rs。

main.rs 内容如下（我们用一个全新的输出语句，避免传统的“Hello, world!”）：


fn main() {
    println!("你好，Rust！");
}

保存后，在该目录下编译并运行。类 Unix 终端可以这样做：


rustc main.rs
./main

Windows PowerShell 中运行方式通常如下：


rustc .\main.rs
.\main.exe

期望输出：


你好，Rust！

代码剖析

fn main() { ... } 定义了一个函数，main 是每个可执行程序的入口。花括号包住函数体，行尾分号表示语句结束。 println! 末尾的感叹号表明它是一个宏调用，而不是普通函数。Rust 社区推荐使用四个空格缩进；配合自动格式化工具（如 rustfmt）可以保持一致风格。

编译与运行是两个步骤

Rust 采用提前编译（ahead-of-time）的方式：我们先把源代码编译成平台原生的可执行文件，再运行它。这意味着你可以把生成的可执行文件交给未安装 Rust 的用户，依然可以直接运行。对于简单脚本，单用 rustc 足够；但随着项目复杂度提升，我们更需要统一的构建与依赖管理，这正是 Cargo 的作用。

认识 Cargo：构建与包管理工具

大多数 Rust 项目都使用 Cargo 来管理依赖、构建与运行。若你通过官方推荐方式安装 Rust，Cargo 一般会一并装好。用下面的命令查看版本：


cargo --version

用 Cargo 创建并运行项目

我们创建一个全新的演示项目，项目名换成不与教材雷同的名字，例如 first_steps：


cargo new first_steps --bin
cd first_steps

Cargo 会生成标准项目结构：顶层包含 Cargo.toml 配置文件，源代码放在 src 目录。打开 Cargo.toml，可以看到类似如下的内容（示例做了适度化简与现代化设置）：


[package]
name = "first_steps"
version = "0.1.0"
edition = "2021"
 
[dependencies]

src/main.rs 中会有一个最小示例。我们把打印内容换成自己的话，便于辨识：


fn main() {
    println!("从 Cargo 开始我们的 Rust 之旅！");
}

构建项目：


cargo build

运行项目（会在必要时先自动构建）：


cargo run

预期输出：


从 Cargo 开始我们的 Rust 之旅！

当你只想快速检查“能否通过编译”而不生成可执行文件时，可以使用：


cargo check

这条命令通常比 cargo build 更快，适合在高频修改时期反复验证。

调试与发布构建

cargo build 默认使用调试配置，产物位于 target/debug。当你准备发布或进行性能测试时，使用启用优化的发布配置：


cargo build --release

发布构建的可执行文件在 target/release，运行速度更快，但编译时间更长。基准测试时务必使用发布构建的可执行文件进行评估。

目录与约定

使用 Cargo 后，源代码统一放在 src，顶层目录用于 README、许可证与配置等非源码文件。这种约定能让协作更清晰，也便于工具链自动识别。

演练场

本部分我们完成了 Rust 的安装、自检与离线文档访问，动手写出了第一个最小程序，理解了 Rust 将“编译”与“运行”分离的工作方式。我们还用 Cargo 创建了结构规范的项目，掌握了构建（含调试与发布）、运行与快速检查的常用命令。到这里，我们已经具备继续深入学习所需的全部“起步能力”。

最后，我们给出这节课自创的最小示例“代码 + 输出”对照，便于快速对拍：


fn main() {
    println!("你好，Rust！");
}


你好，Rust！