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

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_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 的作用。
大多数 Rust 项目都使用 Cargo 来管理依赖、构建与运行。若你通过官方推荐方式安装 Rust,Cargo 一般会一并装好。用下面的命令查看版本:
|cargo --version
我们创建一个全新的演示项目,项目名换成不与教材雷同的名字,例如 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!