Rust / 系统课时
创建首个项目
创建首个项目
本课将用 Cargo 创建一个可运行的 Rust 项目,认识项目目录、入口文件和清单文件,并完成编译、运行与静态检查,最终建立最小但完整的开发流程。
学习目标
- 使用 Cargo 创建并进入 Rust 项目
- 识别
Cargo.toml与src/main.rs的职责 - 完成运行、检查和重新编译验证
用 Cargo 创建项目
在准备存放代码的目录中执行以下命令。cargo new 会创建项目目录、基础源文件和 Git 忽略规则;项目名会同时成为默认的软件包名。
bash
cargo new hello-rust
cd hello-rust预期结果:
text
Creating binary (application) `hello-rust` package若当前目录已经存在同名文件夹,Cargo 会拒绝覆盖。此时应更换项目名,或确认旧目录无用后再处理,不要直接删除包含代码的目录。
认识基础目录结构
新项目的关键内容如下:
text
hello-rust/
├── Cargo.toml
└── src/
└── main.rsCargo.toml 是项目清单,记录软件包名称、版本、Rust edition 和依赖;src/main.rs 是二进制程序的默认入口。Cargo 约定源代码放在 src 中,因此通常不需要手动指定入口文件。
默认的 src/main.rs 可以直接运行:
rust
fn main() {
println!("Hello, world!");
}预期输出:
text
Hello, world!编译并运行项目
在项目根目录执行 cargo run。该命令会先编译,再启动生成的程序;首次编译会创建 target 目录,用于保存构建产物和中间文件。
bash
cargo run预期结果:
text
Compiling hello-rust v0.1.0 (<PATH>/hello-rust)
Finished `dev` profile [unoptimized + debuginfo] target(s) in <TIME>
Running `target/debug/hello-rust`
Hello, world!<PATH> 和 <TIME> 会随本机路径、Cargo 版本及机器性能变化。再次运行且源码未修改时,Cargo 通常会复用已有产物,因此不会重复编译全部内容。
用 cargo check 快速检查
开发过程中可先执行 cargo check。它会完成语法、类型和借用检查,但通常不生成最终可执行文件,因此反馈速度比完整构建更快。
bash
cargo check预期结果:
text
Checking hello-rust v0.1.0 (<PATH>/hello-rust)
Finished `dev` profile [unoptimized + debuginfo] target(s) in <TIME>如果检查失败,应从第一条错误开始修复。后续错误可能只是前一处问题引发的连锁结果,逐条从上到下处理通常更高效。
本课总结
cargo new可以生成符合约定的最小 Rust 项目Cargo.toml管理项目信息,src/main.rs提供程序入口cargo run用于编译并运行,cargo check用于快速验证代码
下一课预告
下一课将进入基础语法,学习 Rust 变量默认不可变的原因,以及 let、mut、const 和变量遮蔽的使用方式。
按自己的节奏,确认真正理解。