RUST入门.md

2023-12-12 22:55:04

RUST入门

RUST入门
- Hello World
- Cargo

Hello World

mkdir -p projects/hello_world/
cd projects/hello_world

main.rs文件

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

编译和运行

rustc main.rs
./main

格式化：rustfmt

Cargo

Cargo 是 Rust 的构建系统和包管理器。

hello

构建如下：

cargo new hello_world --bin

--bin为默认参数，表示构建二进制程序。可选--lib表示构建库。

nsfoxer@nsfoxer-pc ~/temp> cargo new hello_world --bin
     Created binary (application) `hello_world` package
nsfoxer@nsfoxer-pc ~/temp> tree hello_world
hello_world
├── Cargo.toml
└── src
    └── main.rs

1 directory, 2 files

cargo会同时构建git项目。使用--vcs none禁用git存储。

编译：

cargo build

将获取所有依赖项。

nsfoxer@nsfoxer-pc ~/t/hello_world> tree .
.
├── Cargo.lock
├── Cargo.toml
├── src
│   └── main.rs
└── target
    ├── CACHEDIR.TAG
    └── debug
        ├── build
        ├── deps
        │   ├── hello_world-efb3cc30327658a6
        │   └── hello_world-efb3cc30327658a6.d
        ├── examples
        ├── hello_world
        ├── hello_world.d
        └── incremental
            └── hello_world-2bu9x4t5793bs
                ├── s-g1qy781nco-1nkogqh-2hbtkajf7iavr
                │   ├── 1afbzx1y0x1dbpio.o
                │   ├── 1ko7w99wy4kz2chh.o
                │   ├── 28cobucdo6rhinaa.o
                │   ├── 2goevba305ege8v6.o
                │   ├── 4d0psjpawt67vlja.o
                │   ├── 5byta3abs29cbrhj.o
                │   ├── 5dygtqqmhu41ip90.o
                │   ├── dep-graph.bin
                │   ├── gfq0hw1bwbsq84d.o
                │   ├── query-cache.bin
                │   └── work-products.bin
                └── s-g1qy781nco-1nkogqh.lock

9 directories, 20 files

Cargo.lock包含依赖相关信息。使用--release开启编译优化。

Caogo.toml包含项目的各种元信息。

运行：

./target/debug.hello_world

可以使用cargo run进行编译和运行。

可以使用cargo check进行代码检查。

目标

cargo允许Rust项目声明其各种依赖，并保证始终可重复构建。

引入两个含有各种信息的元数据文件；
获取并构建项目的依赖项；
调用rustc或其他工具进行构建；
使用 Rust 项目的约定(规范/风格)。

依赖

crates.io是 Rust 社区的*存储库，用作发现和下载包的位置。cargo默认配置为，使用它来查找请求的包。

添加依赖

[dependencies]
time = "0.1.12"
regex = "0.1.41"

cargo build将会获取依赖。如果regex在crates.io上更新了，在我们选择cargo update之前，我们仍会使用相同的版本进行构建.

文件布局

.
├── Cargo.lock 			
├── Cargo.toml
├── benches  	# 基准测试
│   └── large-input.rs
├── examples 	# 示例
│   └── simple.rs
├── src
│   ├── bin # 其他可执行文件
│   │   └── another_executable.rs
│   ├── lib.rs # 库文件
│   └── main.rs # 可执行文件
└── tests # 集成测试
    └── some-integration-tests.rs

Carogo.toml && Carogo.lock

Cargo.toml是从广义上描述你的依赖，并由你编写.
Cargo.lock包含有关您的依赖项的确切信息。它由 Cargo 维护，不应手动编辑.
构建其他项目要依赖的库，请将Cargo.lock放置在你的.gitignore
构建可执行文件，如命令行工具或应用程序，请检查Cargo.lock位于git管理下。

[dependencies]
rand = { git = "https://github.com/rust-lang-nursery/rand.git", rev = "9f35b8e" }

如上，依赖于github上的项目，当未指定其他信息时默认依赖github上的最新版本。例子中rev指定github的版本。

Cargo.lock会记录项目第一次构建时依赖版本，此时不需要进行手动添加加具体版本。

当我们准备选择，更新库的版本时，Cargo 会自动重新计算依赖关系，并为我们更新内容：

$ cargo update           # updates all dependencies
$ cargo update -p rand   # updates just “rand”

测试

cargo test:会查找src和tests的测试

码农公寓