Cargo Run Bin 安装与配置指南

Cargo Run Bin 安装与配置指南

cargo-run-bin Build, cache, and run CLI tools scoped in Cargo.toml rather than installing globally. Stop the version drifts across your team, keep it all in sync within your project! 项目地址: https://gitcode.com/gh_mirrors/ca/cargo-run-bin

1. 项目基础介绍

cargo-run-bin 是一个用于在 Rust 项目中构建、缓存和运行 CLI 工具的工具，它允许开发者避免在团队或 CI 环境中全局安装工具，从而保持项目中的工具版本一致。这个项目主要是用 Rust 编程语言编写的。

2. 项目使用的关键技术和框架

• Rust: 作为主要编程语言，提供了内存安全、并发支持和丰富的库。
• Cargo: Rust 的包管理器和构建工具，用于管理项目的依赖和构建过程。
• CLI: 命令行界面，用于与用户交互。

3. 项目安装和配置

准备工作

在开始安装之前，请确保您的系统已经安装了以下工具：

• Rust (至少版本 1.70.0)
• Cargo

您可以通过 Rust 的官方安装指南 来安装 Rust 和 Cargo。

安装步骤

步骤 1: 全局安装 cargo-run-bin

打开终端，运行以下命令全局安装 cargo-run-bin：

cargo install cargo-run-bin

安装完成后，您需要在项目的 .gitignore 文件中添加 .bin/ 目录，以避免将其包含在版本控制中：

echo ".bin/" >> .gitignore

步骤 2: 使用项目包装器

如果您想避免全局安装，可以使用项目包装器。按照以下步骤操作：

1. 在项目中创建一个新的二进制包装器：

cd my/rust/project
cargo new --vcs none --bin tools/cargo-bin

2. 下载 cargo-run-bin 的主程序文件：

curl --output tools/cargo-bin/src/main.rs https://raw.githubusercontent.com/dustinblackman/cargo-run-bin/refs/tags/v1.7.4/src/main.rs

3. 添加 cargo-run-bin 作为依赖项：

cd tools/cargo-bin
cargo add --features cli cargo-run-bin

4. 确保将包装器添加到工作区的 Cargo.toml 文件中：

[workspace]
members = [
    "tools/cargo-bin"
]

5. 在 .cargo/config.toml 文件中添加别名：

[alias]
bin = ["run", "--package", "cargo-bin", "--"]

现在，您可以使用包装器就像它被全局安装一样。

步骤 3: 配置 Cargo.toml

在您的 Cargo.toml 文件中，您需要配置您想要管理的 CLI 工具版本。例如：

[package.metadata.bin]
cargo-binstall = { version = "1.1.2" }
cargo-nextest = { version = "0.9.57", locked = true }
dprint = { version = "0.30.3" }

这样配置后，cargo-run-bin 会自动管理和运行指定版本的 CLI 工具。

结语

按照以上步骤，您应该能够成功安装和配置 cargo-run-bin。现在，您可以开始使用它来管理和运行您的项目中的 CLI 工具，保持版本一致性，简化开发工作流程。

cargo-run-bin Build, cache, and run CLI tools scoped in Cargo.toml rather than installing globally. Stop the version drifts across your team, keep it all in sync within your project! 项目地址: https://gitcode.com/gh_mirrors/ca/cargo-run-bin