Cargo Rust 的包管理器

Cargo->Rust 的包管理器

  • Cargi简介
    • [Cargo 的主要功能](#Cargo 的主要功能)
        • [1. 创建项目](#1. 创建项目)
        • [2. 管理依赖](#2. 管理依赖)
        • [3. 构建项目](#3. 构建项目)
        • [4. 运行项目](#4. 运行项目)
        • [5. 测试代码](#5. 测试代码)
        • [6. 检查代码](#6. 检查代码)
        • [7. 生成文档](#7. 生成文档)
        • [8. 发布和分享包](#8. 发布和分享包)
    • [Cargo 的核心文件](#Cargo 的核心文件)
        • [1. `Cargo.toml`](#1. Cargo.toml)
        • [2. `Cargo.lock`](#2. Cargo.lock)
      • [**Cargo 的生态系统**](#Cargo 的生态系统)
    • 常用命令总结
      • [Hello, Cargo! 示例](#Hello, Cargo! 示例)

Cargi简介

Cargo 是 Rust 的包管理器和构建工具,类似于其他语言中的工具,如 JavaScript 的 npm、Python 的 pip 或 Java的 Maven 等。它是 Rust 生态系统的重要组成部分,默认随 Rust 编译器一起安装。Cargo 简化了依赖管理、项目构建、测试、文档生成等开发工作。

Cargo 的主要功能

查看是否安装了Cargo,一般Cargo是和Rust一起安装的。在命令窗口输入

powershell 复制代码
cargo --version

能正常输出版本号,表示已经安装成功。

1. 创建项目

Cargo 可以快速生成一个新项目的基本结构,包括必要的配置文件和目录:

bash 复制代码
cargo new project_name

这会创建一个包含以下内容的项目:

复制代码
project_name/
├── Cargo.toml   # 项目配置文件
├── src/
    └── main.rs  # 主程序文件
2. 管理依赖

Cargo 使用 Cargo.toml 文件来管理项目依赖,类似于 Python 的 requirements.txt 或 Node.js 的 package.json

powershell 复制代码
[package] -- 是一个区域标题,表示下方内容是配置package的
name = "hello_cargo" -- 项目名称
version = "0.1.0" -- 项目版本
authors= ["Venus"] -- 项目作者
edition = "2021" -- 使用的Rust的版本

[dependencies] -- 会列出项目使用的依赖项,在Rust中,代码的包叫做crate

Cargo.toml 中添加依赖后,运行以下命令会下载并编译依赖:

bash 复制代码
cargo build

依赖示例 (Cargo.toml):

toml 复制代码
[dependencies]
serde = "1.0"       # 添加 serde 库
tokio = { version = "1.0", features = ["full"] }  # 添加 tokio 库并启用特性
3. 构建项目

Cargo 自动管理项目的构建过程,包括编译源代码和依赖库。运行以下命令即可构建项目:

bash 复制代码
cargo build

它会在 target/debug/ 目录下生成调试版本的可执行文件。可以通过 --release 构建优化后的生产版本:

bash 复制代码
cargo build --release

使用cargo build 之后

  • 创建了可执行文件,在target\debug\hello_cargo.exe
  • 第一次运行cargo build会在顶层目录生成cargo.lock文件,该文件负责追踪项目依赖的精确版本,不要手动修改该文件。
4. 运行项目

无需手动调用编译器,直接使用以下命令运行项目:

bash 复制代码
cargo run

该命令cargo run ,编译代码 + 执行结果。

  • 如果已经编译成功了,并且源代码没有进行修改,则会直接运行二进制文件。
5. 测试代码

Rust 提供内置的单元测试支持。使用 Cargo 可以轻松运行测试:

bash 复制代码
cargo test
6. 检查代码

Cargo支持检查代码。

powershell 复制代码
cargo check
  • cargo check 检查代码,确保能通过编译,但是不产生任何可执行文件;
  • cargo build区别是,比cargo build要快很多。
  • 编写代码的时候,可反复使用进行调试。
7. 生成文档

Rust 支持自动文档生成工具 rustdoc,并集成到 Cargo 中。运行以下命令可以生成 HTML 文档:

bash 复制代码
cargo doc --open
8. 发布和分享包

Cargo 支持将项目发布到 Rust 的官方包管理平台 Crates.io。发布时,执行以下命令:

bash 复制代码
cargo publish

Cargo 的核心文件

1. Cargo.toml

这是项目的配置文件,使用 TOML 格式,用于定义项目的元信息、依赖、构建配置等。

示例:

toml 复制代码
[package]
name = "my_project"
version = "0.1.0"
authors = ["Your Name <email@example.com>"]
edition = "2021"

[dependencies]
serde = "1.0"  # 添加依赖库
2. Cargo.lock

此文件记录了所有依赖库的精确版本,确保项目的构建环境一致。通常无需手动修改。


Cargo 的生态系统

  • Crates.io:Rust 的开源包托管平台。开发者可以搜索、下载、发布 Rust 包。
  • Cargo Workspaces:支持管理多个相关的子项目,适合大型项目。

常用命令总结

命令 功能
cargo new <name> 创建新项目
cargo init 初始化现有目录为 Cargo 项目
cargo build 构建项目
cargo run 构建并运行项目
cargo test 运行测试
cargo doc --open 生成并打开文档
cargo update 更新依赖到最新允许版本
cargo publish 发布项目到 Crates.io
cargo check 检查代码

Hello, Cargo! 示例

创建一个项目并运行:

bash 复制代码
cargo new hello_cargo
cd hello_cargo
cargo run

输出:

复制代码
Hello, world!

通过 Cargo,Rust 的开发变得更高效、更组织化,特别是对于依赖管理和构建流程,极大地提升了开发体验。

相关推荐
Samsong4 分钟前
《C++ Primer Plus》读书笔记 第二章 开始学习C++
c++·后端
马尚来5 分钟前
Netty核心技术及源码剖析
后端·netty
Access开发易登软件13 分钟前
Access调用Azure翻译:轻松实现系统多语言切换
后端·python·低代码·flask·vba·access·access开发
考虑考虑13 分钟前
JDK25中的StructuredTaskScope
java·后端·java ee
workpieces17 分钟前
Claude Code 插件系统发布:AI 编程助手进入「可定制化」时代
后端
用户59659061813418 分钟前
appsettings.json 在 ASP.NET Core 中默认加载时,reloadOnChange 参数为 true,即支持配置文件变更自动重新加载。
后端
SimonKing20 分钟前
「String到Date转换失败」:深挖@RequestBody的日期坑
java·后端·程序员
CryptoRzz20 分钟前
python对接印度尼西亚股票数据接口文档
后端
渣哥31 分钟前
Lazy能否有效解决循环依赖?答案比你想的复杂
javascript·后端·面试
qq_124987075334 分钟前
基于Spring Boot的网上招聘服务系统(源码+论文+部署+安装)
java·spring boot·后端·spring·计算机外设