第2章 第 2 章：Cargo 入门与安装指南

要开始使用 Cargo，请先安装 Cargo（和 Rust），并创建你的第一个 crate。

• 安装
• Cargo 入门

安装

安装 Rust 和 Cargo

获取 Cargo 最简单的方式是通过 rustup 安装当前稳定版的 Rust。用 rustup 安装 Rust 的同时也会安装 cargo。

在 Linux 和 macOS 系统上，执行以下命令即可：

curl https://sh.rustup.rs -sSf | sh

这条命令会下载一个脚本并开始安装。如果一切顺利，你会看到如下输出：

Rust is installed now. Great!

在 Windows 上，请下载并运行 rustup-init.exe，它会在控制台中启动安装，成功后会显示上述信息。

之后，你还可以用 rustup 命令来安装 beta 或 nightly 版本的 Rust 和 Cargo。

更多安装选项和信息，请访问 Rust 官网的安装页面。

从源码构建并安装 Cargo

你也可以选择从源码构建 Cargo。

Cargo 入门

本节将快速介绍 cargo 命令行工具，演示它如何为我们生成新的 package、编译其中的 crate，以及运行最终生成的程序。

用 Cargo 创建新 package，使用 cargo new 命令：

$ cargo new hello_world

Cargo 默认使用 --bin 来创建二进制程序；如果想创建库，则传入 --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!” 程序，也就是所谓的二进制 crate。让我们编译它：

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

然后运行它：

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

我们也可以用 cargo run 一步完成编译和运行：

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

更进一步

如需了解关于使用 Cargo 的更多细节，请参阅Cargo 指南