$ cargo new hello_world --bin

• --bin 正在制作一個二進制程序
• --lib 正在創(chuàng)建一個庫(lib)

得到如下目錄:

$ cd hello_world
$ tree .
.
├── Cargo.toml
└── src
    └── main.rs

Cargo.toml 被稱為一個 manifest 元清單，它包含了 Cargo 編譯項目所需的所有元數(shù)據(jù)

[package]
name = "hello_world"
version = "0.1.0"
authors = ["Your Name <you@example.com>"]
edition = "2018"

[dependencies]

入口文件 src/main.rs

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

運行編譯生成 hello_world 二進制文件

$ cargo build
# 文件放入 `target/release` 目錄
$ cargo build --release

然后運行它:

$ ./target/debug/hello_world
Hello, world!

也可以直接使用 cargo run，它會自行編譯并運行它:

$ cargo run
   Running `target/hello_world`
Hello, world!

[package]
# ...
[lib]
# 生成目標與庫的名稱. 本該默認是包名, 替換所有破折號為 下劃線. (Rust `extern crate` 聲明會參考該名；因此，該值必須是可用的有效Rust標識符)
name = "foo"
# 該字段，指向 crate 的入口(位置), 路徑相對于 `Cargo.toml`.
path = "src/lib.rs"
# 一個給目標啟用單元測試 的 標志. 會被 `cargo test`使用.
test = true
# 一個給目標啟用文檔測試 的 標志. 只與庫相關(guān), 不會影響其他部分。會被 `cargo test`使用.
doctest = true
# 一個給目標啟用基準 的 標志. 會被 `cargo bench`使用.
bench = true
# 一個給目標啟用文檔 的 標志. 會被 `cargo doc`使用.
doc = true
# 若該目標為 編譯器擴展, 那要把該字段設(shè)為 true，以讓 Cargo 正確編譯和，可用于所有依賴項.
plugin = false
# 若該目標為 "macros 1.1" 程序宏, 那要把該字段設(shè)為 true
proc-macro = false
# 若設(shè)為 false, `cargo test` 會為 rustc 省略 `--test` 標志, 這阻止它生成測試工具 這在二進制存在，構(gòu)建管理測試運行器本身的情況下，有用.
harness = true
# 若設(shè)置了，那 目標會使用一個與`[package]`配置不同的版本, 也許是，編譯一個庫 2018年版本或，編譯單元測試的2015年版本. 默認情況下所有目標都使用`[package]`中指定的版本進行編譯。
edition = '2015'

創(chuàng)建一個新的 cargo 包

$ cargo init [options] [path]
$ cargo new [options] [path]

• --bin 創(chuàng)建具有二進制目標 (src/main.rs) 的包(默認行為)
• --lib 使用庫目標 (src/lib.rs) 創(chuàng)建一個包
• --edition edition 指定要使用的 Rust 版本。默認值為 2021?？赡艿闹担?015、2018、2021
• --name name 設(shè)置包名。默認為目錄名稱
• --vcs vcs 為給定的版本控制系統(tǒng)（git、hg、pijul 或fossil）初始化一個新的 VCS 存儲庫，或者根本不初始化任何版本控制（無）
• --registry registry 限制僅發(fā)布到該注冊表

$ cargo new foo

# 從 crates.io 安裝或升級軟件包：
$ cargo install ripgrep
# 在當前目錄安裝或重新安裝包：
$ cargo install --path .
# 查看已安裝包的列表：
$ cargo install --list

• --vers version
• --version version 指定要安裝的版本
• --git url 用于安裝指定 crate 的 Git URL
• --branch branch 從 git 安裝時要使用的分支
• --tag tag 從 git 安裝時使用的標記
• --rev sha 從 git 安裝時使用的特定提交
• --path path 要安裝的本地 crate 的文件系統(tǒng)路徑
• --list 列出所有已安裝的軟件包及其版本
• -f, --force 強制覆蓋現(xiàn)有的 crate 或二進制文件

選擇包

• -p spec..., --package spec... Package 指定包
• --workspace Package 工作區(qū)中的全體成員
• --exclude SPEC... 排除指定包

編譯選項

• --target triple 為指定架構(gòu)執(zhí)行 Package
• --target-dir directory 用于存放生成的工件以及中間文件的目錄

特性選擇

• --features features 傳遞以空格或者逗號分隔的列表，其中給出要啟用的特性
• --all-features 為給定的包啟用全部可用特性
• --no-default-features 不啟用給定包的default特性

清單選項

• --manifest-path path 用于指定 Cargo.toml 文件的路徑
• --frozen, --locked 這兩個選項用于保證Cargo.lock文件是最新的
• --offline 禁止Cargo訪問網(wǎng)絡(luò)

混雜選項

• -j N, --jobs N 要并行運行的作業(yè)數(shù)量

$ cargo publish [options]

發(fā)布選項

• --dry-run 在不上傳的情況下執(zhí)行所有檢查
• --token token 身份驗證時使用的 API 令牌
• --no-verify 不要通過構(gòu)建內(nèi)容來驗證內(nèi)容
• --allow-dirty 允許打包具有未提交的 VCS 更改的工作目錄
• --index index 要使用的注冊表索引的 URL
• --registry registry 要發(fā)布到的注冊表的名稱

打包選擇

• -p spec, --package spec 要發(fā)布的包