Rust 入门：详细了解 Cargo 包管理器的使用

Rust 入门：详细了解 Cargo 包管理器的使用

Rust 是一门强调性能与安全的系统编程语言。与其他语言相比，Rust 有一个非常强大的工具叫做 Cargo，它是 Rust 的构建系统和包管理器。对于新手来说，学会使用 Cargo 是迈入 Rust 世界的重要一步。

本文将详细介绍 Cargo 的基本功能和用法，适合对 Rust 完全陌生的新手。

一、什么是 Cargo？

Cargo 是 Rust 官方推荐的构建工具和依赖管理工具。它的功能包括：

• 创建新的 Rust 项目
• 构建项目（编译代码）
• 运行项目
• 管理项目的依赖（添加第三方库）
• 发布自己的库（crate）到 crates.io

你可以把 Cargo 理解为 Node.js 的 npm、Python 的 pip 或 Java 的 Maven。

⚠️ 如果你已经安装了 Rust，那么 Cargo 也已经自动安装好了。可以使用 cargo --version 来检查是否安装成功。

cargo --version

二、使用 Cargo 创建项目

在终端中运行以下命令来创建一个新的项目：

cargo new hello_rust

这个命令会生成一个叫 hello_rust 的新目录，目录结构如下：

hello_rust
├── Cargo.toml       # 配置文件（项目名、版本、依赖等）
└── src
    └── main.rs      # 主程序入口

你可以进入目录查看文件内容：

cd hello_rust

main.rs 文件内容默认是：

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

Cargo.toml 文件内容示例：

[package]
name = "hello_rust"
version = "0.1.0"
edition = "2021"

[dependencies]

三、编译和运行项目

在项目目录中执行以下命令来 编译 项目：

cargo build

编译成功后会生成一个 target 目录，里面是编译好的可执行文件。

要直接 编译并运行 项目，可以使用：

cargo run

输出如下：

   Compiling hello_rust v0.1.0 (路径/hello_rust)
    Finished dev [unoptimized + debuginfo] target(s) in 0.78s
     Running `target/debug/hello_rust`
Hello, world!

四、添加第三方依赖（包）

Rust 社区有一个很大的开源库仓库：crates.io。

例如，我们想使用一个功能强大的字符串处理库 regex（正则表达式），只需要：

第一步：编辑 Cargo.toml

[dependencies]
regex = "1.10.3"  # 这是一个版本号

或者使用命令自动添加：

cargo add regex

⚠️ 如果 cargo add 报错，说明你需要先安装 cargo-edit：

cargo install cargo-edit

第二步：在代码中使用它

use regex::Regex;

fn main() {
    let re = Regex::new(r"^\d{4}-\d{2}-\d{2}$").unwrap();
    let date = "2025-05-20";
    println!("Is date valid? {}", re.is_match(date));
}

第三步：运行项目

cargo run

输出：

Is date valid? true

五、构建发布版本（release）

开发时默认是调试模式（debug），速度较慢。如果你想生成优化后的可执行文件：

cargo build --release

生成的文件会在 target/release/ 目录下。

六、常用 Cargo 命令速查表

七、总结

Cargo 是 Rust 初学者必须掌握的工具，它让我们：

• 更方便地创建和管理项目
• 自动管理依赖库
• 编译和运行项目变得简单

学会使用 Cargo，你就可以专注于写代码而不用担心太多配置问题。