【Rust教程 | 基础系列2 | Cargo工具】Cargo介绍及使用

news/2025/3/4 4:20:27/

在这里插入图片描述


文章目录

  • 前言
  • 一,Cargo介绍
    • 1,Cargo安装
    • 2,创建Rust项目
    • 2,编译项目:
    • 3,运行项目:
    • 4,测试项目:
    • 5,更新项目的依赖:
    • 6,生成项目的文档:
  • 二,Cargo常用命令
  • 三,Cargo常用参数
  • 总结


前言

在编程世界中,工具的选择与使用同样重要,甚至有时候比编程语言本身更为重要。对于Rust来说,Cargo就是这样一款强大的工具。本文将详细介绍Cargo的各项功能,并通过实例演示如何使用这些功能。希望通过本文,读者能够熟练掌握Cargo的使用,从而更好地进行Rust开发。


一,Cargo介绍

Cargo是Rust的官方构建工具和包管理器,它的出现极大地提升了Rust的易用性和开发效率。无论是创建新的Rust项目,还是管理项目的依赖,Cargo都能提供极大的便利。

1,Cargo安装

在安装Rust时,Cargo也会被一同安装。可以通过在终端中输入以下命令来验证Cargo的安装:

cargo --version

如果Cargo已经成功安装,该命令将会输出Cargo的版本信息。
在这里插入图片描述

2,创建Rust项目

创建新的Rust项目是Cargo的一个基本功能。在终端中,运行以下命令:

cargo new my_project

这将创建一个名为my_project的新项目,其中包含了基本的目录结构和一个简单的"Hello, World!"程序。项目的目录结构如下:

my_project
├── Cargo.toml
└── src└── main.rs

在这个目录结构中,Cargo.toml是项目的配置文件,src目录是源代码的存放位置,main.rs是主程序文件。

Cargo.toml文件是Cargo的配置文件,它定义了项目的名称,版本,作者等信息,以及项目的依赖。一个基本的Cargo.toml文件如下:

[package]
name = "my_project"
version = "0.1.0"
edition = "2018"[dependencies]
  • 在[package]部分,定义了包的基本信息,如名称,版本和Rust的版本。
  • 在[dependencies]部分,列出了项目的依赖。如果项目需要使用其他的Rust库,可以在这里添加。

src/main.rs文件是项目的主程序文件。在一个新创建的项目中,它包含一个简单的"Hello, World!"程序:

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

2,编译项目:

编译Rust项目是Cargo的一个基本功能。在终端中,只需运行cargo build命令,Cargo就会编译当前目录下的Rust项目。如果项目有未下载的依赖,Cargo会自动下载并编译它们。

cargo build

这个命令会在项目的根目录下生成一个名为target的文件夹,其中包含了编译生成的二进制文件和库文件。默认情况下,这个命令会以debug模式进行编译,这意味着编译出的程序包含了调试信息,但是没有进行优化。

如果想要编译出一个用于发布的、优化过的程序,可以使用cargo build --release命令。这个命令会以release模式进行编译,编译出的程序进行了优化,运行速度更快,但是不包含调试信息。

cargo build --release

在release模式下编译的程序会被放在target/release目录下,而在debug模式下编译的程序则会被放在target/debug目录下。

值得注意的是,编译Rust项目可能需要一些时间,特别是在第一次编译或者在添加了新的依赖之后。但是,Cargo会缓存编译结果,所以在没有修改代码或者依赖的情况下,再次编译会非常快。

3,运行项目:

cargo run命令是Cargo的一个重要命令,它的作用是编译并运行Rust项目。这个命令会先检查源代码是否有更改,如果有更改,它会先编译项目,然后运行编译后的程序。

例如,假设有一个名为"my_project"的Rust项目,项目的主程序在"src/main.rs"文件中。在项目的根目录下运行cargo run命令,Cargo会编译并运行这个项目。

cargo run

如果编译成功,会看到类似以下的输出:

   Compiling my_project v0.1.0 (/path/to/my_project)Finished dev [unoptimized + debuginfo] target(s) in 0.52sRunning `target/debug/my_project`
Hello, world!

这里,"Hello, world!"是"src/main.rs"文件中程序的输出。

如果源代码没有更改,cargo run命令会直接运行已经编译好的程序,而不会再次编译。这可以节省不必要的编译时间。

cargo run命令还可以接受命令行参数。这些参数会被传递给Rust程序。例如,如果Rust程序需要一个文件名作为参数,可以这样运行:

cargo run filename.txt

这里,"filename.txt"是传递给Rust程序的参数。

4,测试项目:

在Rust中,测试是一种非常重要的编程实践,可以帮助开发者确保代码的正确性和稳定性。Cargo提供了一种简单的方式来创建和运行测试。

在Rust中,测试通常写在源代码文件中,位于特殊的#[cfg(test)]模块内,这个模块只在运行cargo test命令时被编译和运行。在这个模块内,每一个以#[test]属性标记的函数都是一个测试函数,Cargo会自动找到并运行这些测试。

例如,以下是一个简单的测试:

#[cfg(test)]
mod tests {#[test]fn it_works() {assert_eq!(2 + 2, 4);}
}

在这个例子中,it_works函数是一个测试,它检查2 + 2是否等于4。如果等于4,测试就会通过;如果不等于4assert_eq!宏会引发一个panic,测试就会失败。

要运行测试,只需要在终端中输入cargo test命令。Cargo会自动找到并运行所有的测试,然后报告测试结果。

cargo test

除了基本的测试外,Rust还支持更复杂的测试形式,如集成测试、文档测试等。集成测试是在tests目录下的独立文件中编写的,用于测试库的公有接口是否正确。文档测试则是在文档注释中编写的,可以同时作为示例代码和测试。

5,更新项目的依赖:

在Rust项目中,依赖是非常重要的一部分。这些依赖,也被称为crate,是Rust的库或者包,可以被其他项目引用和使用。在Rust项目中,所有的依赖都会在Cargo.toml文件中的[dependencies]部分进行声明。

例如,如果项目需要使用到名为"rand"的库,可以在Cargo.toml文件中添加如下内容:

[dependencies]
rand = "0.8.3"

在添加了新的依赖后,运行cargo build命令,Cargo会自动下载并编译所需的依赖。

6,生成项目的文档:

生成项目文档是Cargo的一项重要功能。Rust的文档生成工具叫做rustdoc,它可以从Rust源代码中提取文档注释并生成HTML文档。Cargo提供了一个方便的命令cargo doc来调用rustdoc并生成项目的文档。

在Rust中,可以使用三个斜杠///来为函数、结构体、模块等添加文档注释。例如:

/// 这是一个示例函数。
///
/// # Examples
///
/// ```
/// let result = my_project::example_function(5);
/// assert_eq!(result, 10);
/// ```
pub fn example_function(x: i32) -> i32 {x * 2
}

在这个例子中,example_function函数有一个文档注释,注释中还包含了一个示例代码块。

当在项目的根目录下运行cargo doc命令时,Cargo会调用rustdoc来为项目生成文档。生成的文档会放在target/doc目录下,每个库都会有一个对应的HTML文件。

cargo doc

如果想要在生成文档后立即在浏览器中打开它们,可以使用cargo doc --open命令。

在生成的文档中,可以看到所有公共项的文档注释,以及它们的类型签名和源代码。如果文档注释中包含了示例代码块,rustdoc还会自动测试它们,以确保示例代码的正确性。

总的来说,Cargo和rustdoc为Rust项目的文档生成提供了强大的支持,使得在Rust项目中维护和查阅文档变得非常方便。
在这里插入图片描述


二,Cargo常用命令

以下是Cargo的一些常用命令及其作用,它们可以帮助你更好地管理和构建Rust项目:

命令作用
cargo new NAME创建一个新的Rust项目
cargo build编译当前目录下的Rust项目
cargo run编译并运行当前目录下的Rust项目
cargo test运行当前目录下Rust项目的所有测试
cargo check检查代码是否可以编译,但不生成可执行文件
cargo clean清理项目,删除target目录及其内容
cargo doc为当前目录下的Rust项目生成文档
cargo update更新当前目录下Rust项目的所有依赖
cargo install NAME安装指定的crate到系统
cargo publish发布crate到crates.io
cargo search TERM在crates.io上搜索crate
cargo bench运行项目的基准测试
cargo login TOKEN登录到crates.io
cargo owner管理crate的所有者
cargo package打包一个crate以发布
cargo uninstall从系统中卸载一个crate
cargo version显示Cargo的版本信息

三,Cargo常用参数

以下是Cargo命令的一些常用参数及其作用:

参数作用
--verbose-v显示更多的输出信息
--release编译优化后的版本,而不是默认的调试版本
--bin NAME指定要编译或运行的二进制文件
--example NAME编译或运行项目中的示例代码
--features "FEATURES"启用指定的特性
--no-default-features禁用默认的特性
--all-features启用所有的特性
--target TRIPLE指定编译的目标平台
--manifest-path PATH指定Cargo.toml的路径
--jobs N并行运行的编译作业的数量
--frozen禁止更新Cargo.lock或下载依赖
--locked如果Cargo.lock需要更新,则失败
--offline禁止访问网络

总结

在本文中,我们详细探讨了Cargo的各种功能和使用方法。通过实例演示,我们了解了如何使用Cargo来创建新的Rust项目,如何管理项目的依赖,以及如何使用Cargo来编译和运行Rust代码。希望这些内容能够帮助读者更好地理解和使用Cargo,从而更有效地进行Rust开发。记住,熟练掌握工具的使用,是提升编程效率的关键。在未来的Rust学习和开发中,希望Cargo能成为你的得力助手。

下一章我们将编写并运行第一个Rust程序,感谢大家关注。

文章来源:https://blog.csdn.net/qq_43657810/article/details/132000361
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.ppmy.cn/news/990492.html

相关文章

Exadata磁盘损坏导致磁盘组无法mount恢复(oracle一体机磁盘组异常恢复)---惜分飞

Oracle Exadata客户,在换盘过程中,cell节点又一块磁盘损坏,导致datac1磁盘组(该磁盘组是normal方式冗余)无法mount Thu Jul 20 22:01:21 2023 SQL> alter diskgroup datac1 mount force NOTE: cache registered group DATAC1 number1 incarn0x0728ad12 NOTE: ca…

网络编程(10) : 从connect到三次握手建立连接,再从close到四次挥手断开连接

1、TCP前置知识 1.1什么是TCP TCP 是面向连接的、可靠的、基于字节流的传输层通信协议。 面向连接:必须是一对一建立连接后才能通信可靠的:无论网络链路出现怎么样的变化,TCP可以保证报文一定能被对端收到字节流:流式协议&#…

向npm注册中心发布包(下)

目录 1、在package.json文件中指定dependencies和devDependencies 1.1 将依赖项添加到 package.json 文件 1.2 从命令行中 将依赖项添加到 package.json 文件 1.3 手动编辑 package.json 文件 2、关于语义版本控制 2.1 在已发布的包中增加语义版本 2.2 使用语义版本控制…

SG函数Nim游戏博弈论

移棋子游戏 题目 https://vjudge.csgrandeur.cn/problem/LibreOJ-10243 给定一个有 N 个节点的有向无环图,图中某些节点上有棋子,两名玩家交替移动棋子。 玩家每一步可将任意一颗棋子沿一条有向边移动到另一个点,无法移动者输掉游戏。 对…

速度快\颜色准\功能多,移动端HEIF图片解码实现方案

HEIF图片压缩格式是一种使用HEVC编码技术存储图像数据的方式,在同等质量下相比JPEG可节省50%以上空间,无论是节约包体还是节省带宽,使用HEIF格式都能有所收益。 基于百度智能云音视频处理MCP的自研BD265编码器,百度智能云对象存储…

【Linux命令200例】lsattr用于查看文件或目录的属性

🏆作者简介,黑夜开发者,全栈领域新星创作者✌,2023年6月csdn上海赛道top4。 🏆本文已收录于专栏:Linux命令大全。 🏆本专栏我们会通过具体的系统的命令讲解加上鲜活的实操案例对各个命令进行深入…

MySQL检索数据和排序数据

目录 一、select语句 1.检索单个列(SELECT 列名 FROM 表名;) 2.检索多个列(SELECT 列名1,列名2,列名3 FROM 表名;) 3.检索所有的列(SELECT * FROM 表名;) 4.检索不同的行&#x…

前端文件上传实践与后端处理——文件分块上传

文件上传是现代Web应用程序中常见的功能之一。在这篇博客中,我们将探讨一个简单但完整的前端文件上传实践,同时提供一个后端示例,演示如何处理上传的文件。我们将使用JavaScript作为前端语言,并结合Node.js作为后端环境。让我们开…