Rust中Cargo的使用详解

 更新时间:2022年11月11日 15:44:04   作者:天界程序员  
Cargo 是 Rust 的构建系统和包管理器,⼤多数 Rustacean 们使⽤ Cargo 来管理他们的 Rust 项⽬,因为它可以为你处理很多任务,⽐如构建代码、下载依赖库并编译这些库,这篇文章主要介绍了Rust中Cargo的使用,需要的朋友可以参考下

1、cargo简介

Cargo 是 Rust 的构建系统和包管理器。⼤多数 Rustacean 们使⽤ Cargo 来管理他们的 Rust 项⽬,因为它可以为你处理很多任务,⽐如构建代码、下载依赖库并编译这些库。(我们把代码所需要的库叫做 依赖(dependencies))。

查看cargo版本

cargo --version

我这里可以看到具体的版本好和日期

cargo 1.63.0 (fd9c4297c 2022-07-01)

2、使用cargo创建项目

cargo new hello_cargo
cd hello_cargo

第一行命令,创建了一个名为hello_cargo的目录和项目。

进入目录可以看到以下目录:

|-src
| |-main.rs
|-.gitignore
|-Cargo.toml

2.1、关于Cargo.toml

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

# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
[dependencies]
  • 第一行,[package], 是一个片段(section)标题,表明下面的语句用来配置一个包。随着我们在这个文件增加更多的信息,还将增加其他片段(section)接踵而至的3行设置了Cargo编译程序所需要的配置:name(项目名称)、version(项目的版本)、edition(使用的Rust版本)
  • 最后一行,[dependcies], 是罗列项目依赖的片段的开始,在Rust中,代码包被称为crates。当然在这个项目我们并不需要其他的crate,不过后面我们会用到这个片段。

2.2 、关于src/main.rs

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

​ Cargo为我们自动生成一个“Hello,world!” 程序,正如我们之前编写的示例helloWorld一样,不同的是它将main.rs文件放到了src目录下面。

​ Cargo 期望源文件存放在src目录中。项目根目录只存放 README、license信息、配置文件和其他跟代码无关的文件。使用Cargo帮助你保持项目干净整洁,一切井井有条。

​ 当然如果没有使用Cargo创建的项目,我们也可以转化为一个Cargo项目,比如我之前的HelloWorld项目。我们可以新建目录src、新建源文件main.rs在src目录下、以及创建一个合适的Cargo.toml 文件。

3、构建Cargo项目

我们现在已经使用Cargo创建好了hello_cargo项目,现在我们进入项目目录

cd hello_cargo

然后我们可以使用Cargo中的build命令开始构建项目

cargo build

执行命令后,会打印出如下结果:

Compiling hello_cargo v0.1.0 (D:\RustLang\RustWorkSpace\hello_cargo)
    Finished dev [unoptimized + debuginfo] target(s) in 1.09s

到这里我们首次运行cargo build成功,你会发现此时项目目录中多出了一个target目录和Cargo.lock文件。

这和前端打包类似,如执行npm run build 命令后npm会默认生成一个dist目录,里面就是源码代码经过编译和压缩后可以放在服务器运行的网页页面。其中生成的Cargo.lock文件也和package-lock.json类似,不用说Cargo.toml和package.json 对应。

最后我们可以运行构建成功后生成的可执行文件

.\target\debug\hello_cargo.exe

如果一切顺利,终端上应该打印出Hello,world!

由于默认的构建⽅法是调试构建(debug build),Cargo 会将可执⾏⽂件放在名为 debug 的⽬录中。

4、构建并运行Cargo项目

​ 在认识了cargo build命令,我们知道它是用来构建Cargo项目的,但是运行项目需要我们自己去target目录里面去找到可执行文件,并执行它。

​ 接下来我们来认识一个新的命令cargo run 。它可以构建并运行构建后的可执行文件。

cargo run 

打印结果:

 Finished dev [unoptimized + debuginfo] target(s) in 0.01s
     Running `target\debug\hello_cargo.exe`
Hello, world!

​ 相信到了这里,我们心中一定明白这个命令,今后会是我们的长期合作伙伴,魂牵梦萦那种。

​ 当然有必要说明一下,因为之前我们已经使用cargo build 命令构建了hello_cargo项目 , 所以此时执行的 cargo run 命令并没有重新编译,而是直接运行了可执行文件,打印出了Hello,world!

​ 接下来我们看看,改变了源文件在执行该命令会是什么结果:

 Compiling hello_cargo v0.1.0 (D:\RustLang\RustWorkSpace\hello_cargo)
    Finished dev [unoptimized + debuginfo] target(s) in 0.63s
     Running `target\debug\hello_cargo.exe`
Hello, Rust world!

​ 这里我们看到结果里面有CompilingFinishedRunning 字样,所以我们知道这次它重新编译了该项目,并执行了可执行文件,打印出了新的结果:Hello, Rust world!

5、检查代码是否可编译

​ 接下来我们认识应该新的命令cargo check , 该命令可以快速检查代码确保可以编译,但并不产生可执行文件:

Checking hello_cargo v0.1.0 D:\RustLang\RustWorkSpace\hello_cargo)
Finished dev [unoptimized + debuginfo] target(s) in 0.07s

如果一切顺利控制台会出现以上结果。

​ 到了这里可能有人会问,为什么不直接执行 cargo buildcargo run 命令呢?这样还可以直接生成可执行文件,多方便。

对于一个合格的新时代农民,我们应该持续定期去检查我们的“庄稼”,让它们可以健康成长,这样我们才可以迎来大丰收。不然我们可能会饿肚子!

​ 所以我们要习惯使用cargo check 定期检查我们的代码是否可编译,避免不必要的后顾之忧。

6、发布(release)构建

​ 当项⽬最终准备好发布时,可以使⽤ cargo build --release 来优化编译项⽬。这会在target/release ⽽不是 target/debug 下⽣成可执⾏⽂件。这些优化可以让 Rust 代码运⾏的更快,不过启⽤这些优化也需要消耗更⻓的编译时间。这也就是为什么会有两种不同的配置:⼀种是为了开发,你需要经常快速重新构建;另⼀种是为⽤户构建最终程序,它们不会经常重新构建,并且希望程序运⾏得越快越好。如果你在测试代码的运⾏时间,请确保运⾏ cargo build --release 并使⽤ target/release 下的可执⾏⽂件进⾏测试。

​ 对于运行发行版本我们可以使用 cargo run --release 命令

 Finished release [optimized] target(s) in 0.01s
     Running `target\release\hello_cargo.exe`
Hello, Rust world!

7、把Cargo当作习惯

​ 对于简单项目,Cargo并不比rustc提供了更多的优势,不过随着开发深入,最终会证明它的价值,⼀旦程序壮⼤到由多个⽂件组成,亦或者是需要其他的依赖,让 Cargo 协调构建过程就会简单得多。

​ 即便 hello_cargo 项⽬⼗分简单,它现在也使⽤了很多在你之后的 Rust ⽣涯将会⽤到的实⽤⼯具。其实,要在任何已存在的项⽬上⼯作时,可以使⽤如下命令通过 Git 检出代码,移动到该项⽬⽬录并构建:

git clone example.com/test_project
cd test_project
cargo build

了解更多关于Cargo可以查阅Cargo相关文档

8、总结

本章我们学习了Cargo的相关内容:

  • 使用 cargo new 创建项目
  • 使用 cargo build 构建项目
  • 使用 cargo run 一步构建并运行项目
  • 使用 cargo check 在不生成二进制文件的情况下检查项目是否可编译
  • 使用 cargo build --release 构建项目发行版本
  • 使用 cargo run --release 运行发行版本,可测试发布版本的运行时间

使⽤ Cargo 的⼀个额外的优点是,不管你使⽤什么操作系统,其命令都是⼀样的。所以从现在开始本书将不再为 Linux 和 macOS 以及 Windows 提供相应的命令。

到此这篇关于Rust中Cargo的使用的文章就介绍到这了,更多相关Rust Cargo的使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 关于Rust 使用 dotenv 来设置环境变量的问题

    关于Rust 使用 dotenv 来设置环境变量的问题

    在项目中,我们通常需要设置一些环境变量,用来保存一些凭证或其它数据,这时我们可以使用dotenv这个crate,接下来通过本文给大家介绍Rust 使用dotenv来设置环境变量的问题,感兴趣的朋友一起看看吧
    2022-01-01
  • 使用Rust开发小游戏完成过程

    使用Rust开发小游戏完成过程

    这篇文章主要介绍了使用Rust开发小游戏的完整过程,本文通过示例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2023-11-11
  • Rust语言数据类型的具体使用

    Rust语言数据类型的具体使用

    在Rust中,每个值都有一个明确的数据类型,本文主要介绍了Rust语言数据类型的具体使用,具有一定的参考价值,感兴趣的可以了解一下
    2024-04-04
  • Rust 实现 async/await的详细代码

    Rust 实现 async/await的详细代码

    异步编程在 Rust 中的地位非常高,很多 crate 尤其是多IO操作的都使用了 async/await,这篇文章主要介绍了Rust 如何实现 async/await,需要的朋友可以参考下
    2022-09-09
  • Rust 标准库的结构及模块路径详解

    Rust 标准库的结构及模块路径详解

    在 Rust 中,标准库提供了一组核心功能,以帮助开发者执行常见的编程任务,这个路径树可以作为参考,帮助你更好地理解 Rust 标准库的结构和模块之间的关系,本文介绍 Rust 标准库的结构,并提供相应的 use 路径,感兴趣的朋友一起看看吧
    2024-05-05
  • Rust调用函数操作符 . 和 :: 的区别详解

    Rust调用函数操作符 . 和 :: 的区别详解

    在Rust中,.和::操作符都可以用来调用方法,但它们的用法有所不同,所以本文就将详细的给大家介绍一下.和::操作符的区别,感兴趣的同学跟着小编一起来学习吧
    2023-07-07
  • rust中的match表达式使用详解

    rust中的match表达式使用详解

    在rust中提供了一个极为强大的控制流运算符match,这篇文章主要介绍了rust中的match表达式,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-08-08
  • RUST异步流处理方法详细讲解

    RUST异步流处理方法详细讲解

    这篇文章主要介绍了RUST异步流处理方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习吧
    2022-12-12
  • 详解Rust中的所有权机制

    详解Rust中的所有权机制

    Rust 语言提供了跟其他系统编程语言相同的方式来控制你使用的内存,但拥有数据所有者在离开作用域后自动清除其数据的功能意味着你无须额外编写和调试相关的控制代码,这篇文章主要介绍了Rust中的所有权机制,需要的朋友可以参考下
    2022-10-10
  • 使用Rust制作康威生命游戏的实现代码

    使用Rust制作康威生命游戏的实现代码

    这篇文章主要介绍了使用Rust制作康威生命游戏,初始rust项目,使用wasm的项目模板,结合实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-09-09

最新评论