[Rust][cargo] 使用cargo创建标准rust项目

01 确认安装

rustup --version
cargo --version

02 创建项目

使用cargo创建新项目

cargo new my_project

会创建一个基本结构目录

my_project/
├── Cargo.toml  # 项目配置文件
└── src
    └── main.rs  # 主程序文件

其实内部还会替你创建一个.git和附带的.gitignore文件

03 结构说明

Cargo.toml文件

[package]
name = "my_project"
version = "0.1.0"
edition = "2024"  # Rust版本

[dependencies]   # 此处添加依赖

src/main.rs文件

默认文件路口，包含简单的"Hello，World"程序

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

04 构建和运行项目

# 构建项目，默认为debug
cargo build

# 运行项目
cargo run

# 检查代码（不生成可执行文件）
cargo check

# 发布构建（优化）
cargo build --release

首次运行cargo build、run或者test的时候会自动生成一个Cargo.lock文件

# This file is automatically @generated by Cargo.
# It is not intended for manual editing.
version = 4

[[package]]
name = "my_project"
version = "0.1.0"

该文件由cargo自动生成并负责维护，只有在运行cargo update的时候才会更新

cargo update

05 添加依赖

编辑 Cargo.toml 文件，在 [dependencies] 部分添加需要的 crate：

[dependencies]
rand = "0.8.5"  # 添加随机数库

然后运行 cargo build，Cargo 会自动下载并编译依赖。

06 创建库项目

cargo new --lib my_lib

会创建lib.rs而非main.rs

pub fn add(left: u64, right: u64) -> u64 {
    left + right
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn it_works() {
        let result = add(2, 2);
        assert_eq!(result, 4);
    }
}

08 其他cargo命令

# 运行测试
cargo test

# 生成文档
cargo doc --open

# 清理构建文件
cargo clean

# 安装二进制 crate
cargo install crate_name