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.rs

Cargo.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 和变量遮蔽的使用方式。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建首个项目

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通