我们使用 Cargo 创建一个新项目,然后看看与上面的 ”Hello, world!” 项目有什么不同。回到 projects 目录(或者你存放代码的目录)。接着,可在任何操作系统下运行以下命令:
$ cd hello_cargo
第一行命令新建了名为 hello_cargo 的目录。我们将项目命名为 hello_cargo,同时 Cargo 在一个同名目录中创建项目文件。
进入 hello_cargo 目录并列出文件。将会看到 Cargo 生成了两个文件和一个目录:一个 Cargo.toml 文件,一个 src 目录,以及位于 src 目录中的 main.rs 文件。
这也会在 hello_cargo 目录初始化了一个 git 仓库,以及一个 .gitignore 文件。如果在一个已经存在的 git仓库中运行 cargo new,则这些 git 相关文件则不会生成;可以通过运行 cargo new −−vcs=git 来覆盖这些行为。
请自行选用文本编辑器打开 Cargo.toml 文件。它应该看起来如示例 1-2 所示:
文件名: Cargo.toml
name = "hello_cargo"
version = "0.1.0"
edition = "2021"
[dependencies]
示例 1-2: cargo new 命令生成的 Cargo.toml 的内容
这个文件使用 TOML (Tom’s Obvious, Minimal Language) 格式,这是 Cargo 配置文件的格式。
第一行,[package],是一个片段(section)标题,表明下面的语句用来配置一个包。随着我们在这个文件增加更多的信息,还将增加其他片段(section)。
接下来的三行设置了 Cargo 编译程序所需的配置:项目的名称、项目的版本以及要使用的 Rust 版本。
附录 E 会介绍 edition 的值。
最后一行,[dependencies],是罗列项目依赖的片段的开始。在 Rust 中,代码包被称为 crates。这个项目并不需要其他的 crate,不过在第二章的第一个项目会用到依赖,那时会用得上这个片段。
现在打开 src∕main.rs 看看:
fn main() {
println!("Hello, world!");
}
Cargo 为你生成了一个 ”Hello, world!” 程序,正如我们之前编写的示例 1-1!目前为止,之前项目与Cargo 生成项目的区别是 Cargo 将代码放在 src 目录,同时项目根目录包含一个 Cargo.toml 配置文件。
Cargo 期望源文件存放在 src 目录中。项目根目录只存放 README、license 信息、配置文件和其他跟代码无关的文件。使用 Cargo 帮助你保持项目干净整洁,一切井井有条。
如果没有使用 Cargo 开始项目,比如我们创建的 Hello,world! 项目,可以将其转化为一个 Cargo 项目。
将代码放入 src 目录,并创建一个合适的 Cargo.toml 文件。