初次使用 Cargo

本部分简要介绍cargo命令工具。我们将展示其构建 package，编译 package 内 crate，以及其运行由此产生的程序的能力。

要使用 Cargo 启动新项目，请使用cargo new:

$ cargo new hello_world --bin

Cargo 默认附带 --bin 来创建二进制程序。所以为了构建一个库 (lib)，我们需要传递 --lib。

让我们来看看 Cargo 为我们生成了什么:

$ cd hello_world
$ tree .
.
├── Cargo.toml
└── src
    └── main.rs

1 directory, 2 files

这就是我们开始所需要的一切。首先，让我们看看Cargo.toml:

[package]
name = "hello_world"
version = "0.1.0"
edition = "2024"

[dependencies]

这被称为一个 manifest，它包含了 Cargo 编译项目所需的所有元数据。

那src/main.rs有啥:

fn main() {
    println!("Hello, world!");
}

Cargo 为我们生成了一份 "hello world" 程序，也就是一份 binary crate。现在来编译它:

$ cargo build
   Compiling hello_world v0.1.0 (file:///path/to/project/hello_world)

然后运行它:

$ ./target/debug/hello_world
Hello, world!

我们也可以直接使用 cargo run 来编译并运行它，这只需要一步:

$ cargo run
     Fresh hello_world v0.1.0 (file:///path/to/project/hello_world)
   Running `target/hello_world`
Hello, world!

更进一步

有关使用 Cargo 的更多详细信息，请查看 Cargo 指南