diff --git a/pages.zh/common/cargo-add.md b/pages.zh/common/cargo-add.md new file mode 100644 index 0000000000..1591de386d --- /dev/null +++ b/pages.zh/common/cargo-add.md @@ -0,0 +1,32 @@ +# cargo add + +> 向 Rust 项目的 `Cargo.toml` 文件添加依赖项。 +> 更多信息:. + +- 将最新版本的依赖项添加到当前项目: + +`cargo add {{依赖项}}` + +- 添加特定版本的依赖项: + +`cargo add {{依赖项}}@{{版本号}}` + +- 添加依赖项并启动一个或多个特定功能: + +`cargo add {{依赖项}} --features {{功能1}},{{功能2}}` + +- 添加一个可选的依赖项,然后将其作为包(crate)的一个功能暴露出来: + +`cargo add {{依赖项}} --optional` + +- 将本地包(crate)添加为依赖项: + +`cargo add --path {{path/to/directory}}` + +- 添加一个开发或构建依赖项: + +`cargo add {{依赖项}} --{{dev|build}}` + +- 添加一个禁用所有默认功能的依赖项: + +`cargo add {{依赖项}} --no-default-features` diff --git a/pages.zh/common/cargo-bench.md b/pages.zh/common/cargo-bench.md new file mode 100644 index 0000000000..17e3fedb5d --- /dev/null +++ b/pages.zh/common/cargo-bench.md @@ -0,0 +1,36 @@ +# cargo bench + +> 编译并执行基准测试。 +> 更多信息:. + +- 执行包的所有基准测试: + +`cargo bench` + +- 在基准测试失败时不停止: + +`cargo bench --no-fail-fast` + +- 编译,但不运行基准测试: + +`cargo bench --no-run` + +- 对指定的基准进行基准测试: + +`cargo bench --bench {{基准测试名称}}` + +- 使用给定的配置文件进行基准测试 (默认为 `bench`): + +`cargo bench --profile {{配置文件}}` + +- 对所有示例目标进行基准测试: + +`cargo bench --examples` + +- 对所有二进制目标进行基准测试: + +`cargo bench --bins` + +- 对包的库(lib)进行基准测试: + +`cargo bench --lib` diff --git a/pages.zh/common/cargo-build.md b/pages.zh/common/cargo-build.md new file mode 100644 index 0000000000..b3f1b5682d --- /dev/null +++ b/pages.zh/common/cargo-build.md @@ -0,0 +1,32 @@ +# cargo build + +> 编译本地包及其所有依赖项。 +> 更多信息:. + +- 在本地路径中构建由 `Cargo.toml` 清单文件定义的一个或多个包: + +`cargo build` + +- 以 release 模式构建,并进行优化: + +`cargo build --release` + +- 要求 `Cargo.lock` 文件为最新版本: + +`cargo build --locked` + +- 构建工作区中的所有包: + +`cargo build --workspace` + +- 构建特定的包: + +`cargo build --package {{包名}}` + +- 仅构建指定的二进制文件: + +`cargo build --bin {{名称}}` + +- 仅构建指定的测试目标: + +`cargo build --test {{测试名称}}` diff --git a/pages.zh/common/cargo-check.md b/pages.zh/common/cargo-check.md new file mode 100644 index 0000000000..56ef1fbf48 --- /dev/null +++ b/pages.zh/common/cargo-check.md @@ -0,0 +1,24 @@ +# cargo check + +> 检查本地软件包及其所有依赖包是否有错误。 +> 更多信息:. + +- 检查当前包: + +`cargo check` + +- 检查所有测试: + +`cargo check --tests` + +- 检查 `tests/integration_test1.rs` 中的集成测试: + +`cargo check --test {{integration_test1}}` + +- 使用 `feature1` 和 `feature2` 功能检查当前包: + +`cargo check --features {{feature1,feature2}}` + +- 禁用默认功能后检测当前包: + +`cargo check --no-default-features` diff --git a/pages.zh/common/cargo-clean.md b/pages.zh/common/cargo-clean.md new file mode 100644 index 0000000000..2f6554b8f7 --- /dev/null +++ b/pages.zh/common/cargo-clean.md @@ -0,0 +1,20 @@ +# cargo clean + +> 删除 `target` 目录中生成的构建产物。 +> 更多信息:. + +- 删除整个 `target` 目录: + +`cargo clean` + +- 删除文档构建产物 (`target/doc` 目录): + +`cargo clean --doc` + +- 删除 release 模式的构建产物 (`target/release` 目录): + +`cargo clean --release` + +- 删除给定配置文件的目录中的构建产物(在本例中为 `target/debug`): + +`cargo clean --profile {{dev}}` diff --git a/pages.zh/common/cargo-clippy.md b/pages.zh/common/cargo-clippy.md new file mode 100644 index 0000000000..f18762d649 --- /dev/null +++ b/pages.zh/common/cargo-clippy.md @@ -0,0 +1,32 @@ +# cargo clippy + +> 一系列 lint 工具,用于捕获常见错误并改进 Rust 代码。 +> 更多信息:. + +- 对当前目录中的代码运行检查: + +`cargo clippy` + +- 要求 `Cargo.lock` 文件是最新的: + +`cargo clippy --locked` + +- 对工作区中的所有包进行检查: + +`cargo clippy --workspace` + +- 对某个包进行检查: + +`cargo clippy --package {{包名}}` + +- 将警告视为错误: + +`cargo clippy -- --deny warnings` + +- 运行检查并忽略警告: + +`cargo clippy -- --allow warnings` + +- 自动应用 Clippy 的建议: + +`cargo clippy --fix` diff --git a/pages.zh/common/cargo-doc.md b/pages.zh/common/cargo-doc.md new file mode 100644 index 0000000000..a4d158cdbc --- /dev/null +++ b/pages.zh/common/cargo-doc.md @@ -0,0 +1,20 @@ +# cargo doc + +> 构建 Rust 包的文档。 +> 更多信息:. + +- 为当前项目及所有依赖项构建文档: + +`cargo doc` + +- 不为依赖项构建文档: + +`cargo doc --no-deps` + +- 构建并在浏览器中打开文档: + +`cargo doc --open` + +- 构建并查看特定包的文档: + +`cargo doc --open --package {{包名}}` diff --git a/pages.zh/common/cargo-fetch.md b/pages.zh/common/cargo-fetch.md new file mode 100644 index 0000000000..36f3ccac6b --- /dev/null +++ b/pages.zh/common/cargo-fetch.md @@ -0,0 +1,12 @@ +# cargo fetch + +> 从网络获取包的依赖项。 +> 更多信息:. + +- 获取 `Cargo.lock` 中指定的依赖项 (对所有目标): + +`cargo fetch` + +- 为指定目标获取依赖项: + +`cargo fetch --target {{目标三元组}}` diff --git a/pages.zh/common/cargo-fix.md b/pages.zh/common/cargo-fix.md new file mode 100644 index 0000000000..6418fea888 --- /dev/null +++ b/pages.zh/common/cargo-fix.md @@ -0,0 +1,28 @@ +# cargo fix + +> 自动修复 `rustc` 报告的 lint 警告。 +> 更多信息:. + +- 即使已经有编译器错误,也要修复代码: + +`cargo fix --broken-code` + +- 即使工作目录有更改,也要修复代码: + +`cargo fix --allow-dirty` + +- 将一个包迁移到下一个 Rust 版本: + +`cargo fix --edition` + +- 修复包的库: + +`cargo fix --lib` + +- 修复指定的集成测试: + +`cargo fix --test {{名称}}` + +- 修复工作区中的所有成员: + +`cargo fix --workspace` diff --git a/pages.zh/common/cargo-fmt.md b/pages.zh/common/cargo-fmt.md new file mode 100644 index 0000000000..68da445e08 --- /dev/null +++ b/pages.zh/common/cargo-fmt.md @@ -0,0 +1,16 @@ +# cargo fmt + +> 在 Rust 项目中对所有源文件运行 `rustfmt`。 +> 更多信息:. + +- 格式化所有源文件: + +`cargo fmt` + +- 检查格式错误,不对文件进行写入操作: + +`cargo fmt --check` + +- 将参数传递给每个 rustfmt 调用: + +`cargo fmt -- {{rustfmt参数}}` diff --git a/pages.zh/common/cargo-generate-lockfile.md b/pages.zh/common/cargo-generate-lockfile.md new file mode 100644 index 0000000000..2057c0f954 --- /dev/null +++ b/pages.zh/common/cargo-generate-lockfile.md @@ -0,0 +1,9 @@ +# cargo generate-lockfile + +> 为当前包生成 Cargo.lock 文件。类似于 cargo update,但选项更少。 +> 如果锁定文件已经存在,它将使用每个包的最新版本重新构建。 +> 更多信息:. + +- 使用每个包的最新版本生成Cargo.lock文件: + +`cargo generate-lockfile` diff --git a/pages.zh/common/cargo-help.md b/pages.zh/common/cargo-help.md new file mode 100644 index 0000000000..97cdac0f65 --- /dev/null +++ b/pages.zh/common/cargo-help.md @@ -0,0 +1,12 @@ +# cargo help + +> 显示有关 cargo 及其子命令的帮助信息。 +> 更多信息:. + +- 显示一般帮助: + +`cargo help` + +- 显示子命令的帮助信息: + +`cargo help {{子命令}}` diff --git a/pages.zh/common/cargo-init.md b/pages.zh/common/cargo-init.md new file mode 100644 index 0000000000..5953919a5d --- /dev/null +++ b/pages.zh/common/cargo-init.md @@ -0,0 +1,25 @@ +# cargo init + +> 创建一个新的 Cargo 包。 +> 相当于 `cargo new`,但是指定目录是可选的。 +> 更多信息:. + +- 在当前目录中初始化一个带有二进制目标的 Rust 项目: + +`cargo init` + +- 在指定目录中初始化一个带有二进制目标的 Rust 项目: + +`cargo init {{path/to/directory}}` + +- 在当前目录中初始化一个带有库目标的 Rust 项目: + +`cargo init --lib` + +- 在项目目录中初始化版本控制系统仓库 (默认为git): + +`cargo init --vcs {{git|hg|pijul|fossil|none}}` + +- 设置包名称 (默认为目录名称): + +`cargo init --name {{name}}` diff --git a/pages.zh/common/cargo-install.md b/pages.zh/common/cargo-install.md new file mode 100644 index 0000000000..b5739f8ad7 --- /dev/null +++ b/pages.zh/common/cargo-install.md @@ -0,0 +1,20 @@ +# cargo install + +> 构建并安装一个 Rust 二进制文件。 +> 更多信息:. + +- 从 安装一个包 (版本是可选的,默认为最新版本): + +`cargo install {{包名}}@{{版本号}}` + +- 从指定的 Git 仓库安装一个包: + +`cargo install --git {{仓库URL}}` + +- 从 Git 仓库安装时,根据指定的 branch/tag/commit 构建: + +`cargo install --git {{仓库URL}} --{{branch|tag|rev}} {{branch_name|tag|commit_hash}}` + +- 列出所有已安装的包及其版本: + +`cargo install --list` diff --git a/pages.zh/common/cargo-locate-project.md b/pages.zh/common/cargo-locate-project.md new file mode 100644 index 0000000000..4bdf3bac6a --- /dev/null +++ b/pages.zh/common/cargo-locate-project.md @@ -0,0 +1,21 @@ +# cargo locate-project + +> 打印项目的 `Cargo.toml` 清单文件的完整路径。 +> 如果项目是工作区的一部分,则显示项目的清单文件,而不是工作区的清单文件。 +> 更多信息:. + +- 显示包含完整路径到 `Cargo.toml` 清单文件的 JSON 对象: + +`cargo locate-project` + +- 以指定格式显示项目路径: + +`cargo locate-project --message-format {{plain|json}}` + +- 显示位于工作区根目录而不是当前工作区成员的 `Cargo.toml` 清单文件: + +`cargo locate-project --workspace` + +- 显示特定目录中的 `Cargo.toml` 清单文件: + +`cargo locate-project --manifest-path {{path/to/Cargo.toml}}` diff --git a/pages.zh/common/cargo-login.md b/pages.zh/common/cargo-login.md new file mode 100644 index 0000000000..4e7f2af659 --- /dev/null +++ b/pages.zh/common/cargo-login.md @@ -0,0 +1,13 @@ +# cargo login + +> 将 API 令牌保存到本地的凭据存储中。 +> 该令牌用于对包注册表进行身份验证。您可以使用 `cargo logout` 来删除它。 +> 更多信息:. + +- 将 API 令牌添加到本地凭据存储中 (位于 `$CARGO_HOME/credentials.toml`): + +`cargo login` + +- 使用指定的注册表 (注册表名称可以在配置中定义,默认为 ): + +`cargo login --registry {{名称}}` diff --git a/pages.zh/common/cargo-logout.md b/pages.zh/common/cargo-logout.md new file mode 100644 index 0000000000..9452d4c31b --- /dev/null +++ b/pages.zh/common/cargo-logout.md @@ -0,0 +1,13 @@ +# cargo logout + +> 从本地注册表中删除 API 令牌。 +> 该令牌用于对包注册表进行身份验证。您可以使用 `cargo login` 将其添加回来。 +> 更多信息:. + +- 从本地凭据存储中 (位于 `$CARGO_HOME/credentials.toml`) 移除 API 令牌: + +`cargo logout` + +- 使用指定的注册表 (注册表名称可以在配置中定义,默认为 ): + +`cargo logout --registry {{名称}}` diff --git a/pages.zh/common/cargo-metadata.md b/pages.zh/common/cargo-metadata.md new file mode 100644 index 0000000000..0f8609fa42 --- /dev/null +++ b/pages.zh/common/cargo-metadata.md @@ -0,0 +1,21 @@ +# cargo metadata + +> 以 JSON 格式输出当前包的工作空间成员和已解析的依赖关系。 +> 注意:输出格式可能在未来的 Cargo 版本中发生变化。 +> 更多信息:. + +- 打印当前包的工作空间成员和已解析的依赖关系: + +`cargo metadata` + +- 仅打印工作空间成员,不获取依赖项: + +`cargo metadata --no-deps` + +- 根据指定版本打印特定格式的元数据: + +`cargo metadata --format-version {{版本号}}` + +- 打印带有 `resolve` 字段的元数据,仅包括给定目标三元组的依赖关系 (注意:`packages` 数组仍将包括所有目标的依赖关系): + +`cargo metadata --filter-platform {{目标三元组}}` diff --git a/pages.zh/common/cargo-new.md b/pages.zh/common/cargo-new.md new file mode 100644 index 0000000000..fcfe936602 --- /dev/null +++ b/pages.zh/common/cargo-new.md @@ -0,0 +1,9 @@ +# cargo new + +> 创建一个新的 Cargo 包。 +> 相当于 `cargo init`,但是需要指定一个目录。 +> 更多信息:. + +- 使用二进制目标创建一个新的 Rust 项目: + +`cargo new {{path/to/directory}}` diff --git a/pages.zh/common/cargo-owner.md b/pages.zh/common/cargo-owner.md new file mode 100644 index 0000000000..1994184e15 --- /dev/null +++ b/pages.zh/common/cargo-owner.md @@ -0,0 +1,20 @@ +# cargo owner + +> 管理包在注册表上的所有者。 +> 更多信息:. + +- 邀请指定的用户或团队作为所有者: + +`cargo owner --add {{用户名|github:机构名称:团队名称}} {{包名}}` + +- 将指定的用户或团队从所有者中删除: + +`cargo owner --remove {{用户名|github:机构名称:团队名称}} {{包名}}` + +- 列出一个包的所有者: + +`cargo owner --list {{包名}}` + +- 使用指定的注册表 (注册表名称可以在配置中定义,默认为 ): + +`cargo owner --registry {{名称}}` diff --git a/pages.zh/common/cargo-package.md b/pages.zh/common/cargo-package.md new file mode 100644 index 0000000000..336f7b519d --- /dev/null +++ b/pages.zh/common/cargo-package.md @@ -0,0 +1,13 @@ +# cargo package + +> 将本地包装成一个可分发的 tarball 文件(`.crate` 文件)。 +> 类似于 `cargo publish --dry-run`,但具有更多选项。 +> 更多信息:. + +- 执行检查并创建一个 `.crate` 文件 (相当于 `cargo publish --dry-run`): + +`cargo package` + +- 显示将包含在tarball中的文件,而不实际创建它: + +`cargo package --list` diff --git a/pages.zh/common/cargo-pkgid.md b/pages.zh/common/cargo-pkgid.md new file mode 100644 index 0000000000..27d92ca1c5 --- /dev/null +++ b/pages.zh/common/cargo-pkgid.md @@ -0,0 +1,12 @@ +# cargo pkgid + +> 打印当前工作空间中包或依赖项的完全限定包 ID 指定符。 +> 更多信息:. + +- 打印当前项目的完全限定包规范: + +`cargo pkgid` + +- 打印指定包的完全限定包规范: + +`cargo pkgid {{部分包规范}}` diff --git a/pages.zh/common/cargo-publish.md b/pages.zh/common/cargo-publish.md new file mode 100644 index 0000000000..c22e7494fa --- /dev/null +++ b/pages.zh/common/cargo-publish.md @@ -0,0 +1,17 @@ +# cargo publish + +> 将包上传到注册表。 +> 注意:在发布包之前,您必须使用 `cargo login` 添加身份验证令牌。 +> 更多信息:. + +- 执行检查,创建一个 `.crate` 文件并将其上传到注册表: + +`cargo publish` + +- 执行检查,创建一个 `.crate` 文件,但不上传它 (相当于 `cargo package`): + +`cargo publish --dry-run` + +- 使用指定的注册表 (注册表名称可以在配置中定义,默认为 ): + +`cargo publish --registry {{名称}}` diff --git a/pages.zh/common/cargo-remove.md b/pages.zh/common/cargo-remove.md new file mode 100644 index 0000000000..11daef929e --- /dev/null +++ b/pages.zh/common/cargo-remove.md @@ -0,0 +1,16 @@ +# cargo remove + +> 从 Rust 项目的 `Cargo.toml` 清单中移除依赖关系。 +> 更多信息:. + +- 从当前项目中移除一个依赖项: + +`cargo remove {{依赖项}}` + +- 移除开发或构建依赖项: + +`cargo remove --{{dev|build}} {{依赖项}}` + +- 移除给定目标平台的依赖项: + +`cargo remove --target {{目标平台}} {{依赖项}}` diff --git a/pages.zh/common/cargo-report.md b/pages.zh/common/cargo-report.md new file mode 100644 index 0000000000..4ef9fbc201 --- /dev/null +++ b/pages.zh/common/cargo-report.md @@ -0,0 +1,16 @@ +# cargo report + +> 显示各种类型的报告。 +> 更多信息:. + +- 显示一个报告: + +`cargo report {{future-incompatibilities|...}}` + +- 显示具有指定由 Cargo 生成的 id 的报告: + +`cargo report {{future-incompatibilities|...}} --id {{id}}` + +- 为指定的包显示报告: + +`cargo report {{future-incompatibilities|...}} --package {{package}}` diff --git a/pages.zh/common/cargo-run.md b/pages.zh/common/cargo-run.md new file mode 100644 index 0000000000..62a3cbae62 --- /dev/null +++ b/pages.zh/common/cargo-run.md @@ -0,0 +1,33 @@ +# cargo run + +> 运行当前的 Cargo 包。 +> 注意: 执行的二进制文件的工作目录将设置为当前工作目录。 +> 更多信息:. + +- 运行默认的二进制目标: + +`cargo run` + +- 运行指定的二进制文件: + +`cargo run --bin {{名称}}` + +- 运行指定的示例: + +`cargo run --example {{示例名}}` + +- 激活一系列以空格或逗号分隔的功能: + +`cargo run --features {{功能1 功能2 ...}}` + +- 禁用默认功能: + +`cargo run --no-default-features` + +- 激活所有可用的功能: + +`cargo run --all-features` + +- 使用指定的配置文件运行: + +`cargo run --profile {{配置文件名称}}` diff --git a/pages.zh/common/cargo-rustc.md b/pages.zh/common/cargo-rustc.md new file mode 100644 index 0000000000..9de3b66cb7 --- /dev/null +++ b/pages.zh/common/cargo-rustc.md @@ -0,0 +1,37 @@ +# cargo rustc + +> 编译一个 Rust 包。类似于 `cargo build`,但您可以向编译器传递额外的选项。 +> 查看 `rustc --help` 获取所有可用选项。 +> 更多信息:. + +- 构建包并向 `rustc` 传递选项: + +`cargo rustc -- {{rustc_options}}` + +- 在 release 模式下构建构建,启用优化: + +`cargo rustc --release` + +- 使用针对当前 CPU 的特定架构优化编译: + +`cargo rustc --release -- -C target-cpu=native` + +- 使用速度优化编译: + +`cargo rustc -- -C opt-level {{1|2|3}}` + +- 使用 [s]ize 优化编译(`z` 也会关闭循环向量化): + +`cargo rustc -- -C opt-level {{s|z}}` + +- 检查您的包是否使用了不安全的代码: + +`cargo rustc --lib -- -D unsafe-code` + +- 构建特定的包: + +`cargo rustc --package {{package}}` + +- 仅构建指定的二进制文件: + +`cargo --bin {{名称}}` diff --git a/pages.zh/common/cargo-rustdoc.md b/pages.zh/common/cargo-rustdoc.md new file mode 100644 index 0000000000..8d96c5474c --- /dev/null +++ b/pages.zh/common/cargo-rustdoc.md @@ -0,0 +1,33 @@ +# cargo rustdoc + +> 构建 Rust 包的文档。 +> 类似于 `cargo doc`,但您可以向 `rustdoc` 传递选项。查看 `rustdoc --help` 获取所有可用选项。 +> 更多信息:. + +- 向 `rustdoc` 传递选项: + +`cargo rustdoc -- {{rustdoc_options}}` + +- 关于文档 lint 发出警告: + +`cargo rustdoc -- --warn rustdoc::{{lint_name}}` + +- 忽略文档 lint: + +`cargo rustdoc -- --allow rustdoc::{{lint_name}}` + +- 为包的库生成文档: + +`cargo rustdoc --lib` + +- 为指定的二进制文件生成文档: + +`cargo rustdoc --bin {{名称}}` + +- 为指定的示例生成文档: + +`cargo rustdoc --example {{名称}}` + +- 为指定的集成测试生成文档: + +`cargo rustdoc --test {{名称}}` diff --git a/pages.zh/common/cargo-search.md b/pages.zh/common/cargo-search.md new file mode 100644 index 0000000000..05bb0e347e --- /dev/null +++ b/pages.zh/common/cargo-search.md @@ -0,0 +1,13 @@ +# cargo search + +> 在 https://crates.io 上搜索包。 +> 显示包及其描述,以 TOML 格式显示,可复制到 `Cargo.toml` 中。 +> 更多信息:. + +- 搜索包: + +`cargo search {{查询词}}` + +- 显示 n 个结果 (默认为 10,最多为 100): + +`cargo search --limit {{n}} {{查询词}}` diff --git a/pages.zh/common/cargo-test.md b/pages.zh/common/cargo-test.md new file mode 100644 index 0000000000..eb1b06a4d6 --- /dev/null +++ b/pages.zh/common/cargo-test.md @@ -0,0 +1,28 @@ +# cargo test + +> 执行 Rust 包的单元测试和集成测试。 +> 更多信息:. + +- 仅运行包含特定字符串在其名称中的测试: + +`cargo test {{测试名称}}` + +- 设置并行运行测试用例的数量: + +`cargo test -- --test-threads {{数量}}` + +- 在 release 模式下测试构建,启用优化: + +`cargo test --release` + +- 测试工作区中的所有包: + +`cargo test --workspace` + +- 为特定包运行测试: + +`cargo test --package {{包名}}` + +- 运行测试时不隐藏测试执行的输出: + +`cargo test -- --nocapture` diff --git a/pages.zh/common/cargo-tree.md b/pages.zh/common/cargo-tree.md new file mode 100644 index 0000000000..5c4783f090 --- /dev/null +++ b/pages.zh/common/cargo-tree.md @@ -0,0 +1,25 @@ +# cargo tree + +> 显示依赖图的树形可视化。 +> 注意:在树中,标有 `(*)` 的包的依赖已在图的其他位置显示过,因此不会重复显示。 +> 更多信息:. + +- 显示当前项目的依赖树: + +`cargo tree` + +- 仅显示到指定深度的依赖 (例如,当 `n` 为 1 时,仅显示直接依赖): + +`cargo tree --depth {{n}}` + +- 在树中不显示给定的包(及其依赖): + +`cargo tree --prune {{package_spec}}` + +- 显示重复依赖的所有出现: + +`cargo tree --no-dedupe` + +- 仅显示 normal/build/dev 依赖: + +`cargo tree --edges {{normal|build|dev}}` diff --git a/pages.zh/common/cargo-uninstall.md b/pages.zh/common/cargo-uninstall.md new file mode 100644 index 0000000000..c6577d4ea4 --- /dev/null +++ b/pages.zh/common/cargo-uninstall.md @@ -0,0 +1,8 @@ +# cargo uninstall + +> 移除使用 `cargo install` 安装的 Rust 二进制文件。 +> 更多信息:. + +- 移除一个已安装的二进制文件: + +`cargo remove {{package_spec}}` diff --git a/pages.zh/common/cargo-update.md b/pages.zh/common/cargo-update.md new file mode 100644 index 0000000000..f92bfa1399 --- /dev/null +++ b/pages.zh/common/cargo-update.md @@ -0,0 +1,20 @@ +# cargo update + +> 更新记录在 `Cargo.lock` 中的依赖关系。 +> 更多信息:. + +- 将 `Cargo.lock` 中的依赖项更新为可能的最新版本: + +`cargo update` + +- 显示将会更新的内容,但实际上不写入锁定文件: + +`cargo update --dry-run` + +- 仅更新指定的依赖项: + +`cargo update --package {{依赖项1}} --package {{依赖项2}} --package {{依赖项3}}` + +- 将特定依赖项设置为特定版本: + +`cargo update --package {{依赖项}} --precise {{1.2.3}}` diff --git a/pages.zh/common/cargo-vendor.md b/pages.zh/common/cargo-vendor.md new file mode 100644 index 0000000000..48cfa6f430 --- /dev/null +++ b/pages.zh/common/cargo-vendor.md @@ -0,0 +1,8 @@ +# cargo vendor + +> 将项目的所有依赖项存储到指定目录中(默认为 `vendor`)。 +> 更多信息:. + +- 将依赖项存储到指定目录,并配置在当前项目中使用这些存储的源代码: + +`cargo vendor {{path/to/directory}} > .cargo/config.toml` diff --git a/pages.zh/common/cargo-verify-project.md b/pages.zh/common/cargo-verify-project.md new file mode 100644 index 0000000000..4e27b5df65 --- /dev/null +++ b/pages.zh/common/cargo-verify-project.md @@ -0,0 +1,12 @@ +# cargo verify-project + +> 检查 `Cargo.toml` 文件清单的正确性,并将结果以 JSON 对象的形式打印出来。 +> 更多信息:. + +- 检查当前项目清单的正确性: + +`cargo verify-project` + +- 检查指定清单文件的正确性: + +`cargo verify-project --manifest-path {{path/to/Cargo.toml}}` diff --git a/pages.zh/common/cargo-version.md b/pages.zh/common/cargo-version.md new file mode 100644 index 0000000000..4ac2d6037c --- /dev/null +++ b/pages.zh/common/cargo-version.md @@ -0,0 +1,12 @@ +# cargo version + +> 显示 `cargo` 版本信息。 +> 更多信息:. + +- 显示版本: + +`cargo version` + +- 显示额外的构建信息: + +`cargo version --verbose` diff --git a/pages.zh/common/cargo-yank.md b/pages.zh/common/cargo-yank.md new file mode 100644 index 0000000000..225093bd32 --- /dev/null +++ b/pages.zh/common/cargo-yank.md @@ -0,0 +1,17 @@ +# cargo yank + +> 从索引中移除发布的包。应该只在意外发布了一个严重错误的包时使用。 +> 注意:这不会删除任何数据。包在被撤回后仍然存在,只是阻止新项目使用它。 +> 更多信息:. + +- 撤回指定版本的包: + +`cargo yank {{包名}}@{{版本号}}` + +- 撤销撤回 (即允许再次下载): + +`cargo yank --undo {{包名}}@{{版本号}}` + +- 使用指定的注册表 (注册表名称可以在配置中定义 - 默认为 ): + +`cargo yank --registry {{名称}} {{包名}}@{{版本号}}` diff --git a/pages.zh/common/cargo.md b/pages.zh/common/cargo.md new file mode 100644 index 0000000000..71df2f335b --- /dev/null +++ b/pages.zh/common/cargo.md @@ -0,0 +1,37 @@ +# cargo + +> 管理 Rust 项目及其模块依赖项(crates)。 +> 一些子命令,如 `build`,具有自己的用法文档。 +> 更多信息:. + +- 搜索包: + +`cargo search {{搜索关键词}}` + +- 下载二进制包(crate): + +`cargo install {{包名}}` + +- 列出已安装的二进制包(crate): + +`cargo install --list` + +- 在指定目录 (或默认情况下在当前工作目录) 中创建一个新的二进制或库 Rust项目: + +`cargo init --{{bin|lib}} {{path/to/directory}}` + +- 向当前目录的 `Cargo.toml` 添加一个依赖: + +`cargo add {{依赖项目}}` + +- 使用 release 模式在当前目录中构建 Rust 项目: + +`cargo build --release` + +- 使用最新的编译器在当前目录中构建 Rust 项目 (需要 `rustup`): + +`cargo +nightly build` + +- 使用特定数量的线程构建 (默认为逻辑 CPU 的数量): + +`cargo build --jobs {{线程数}}`