当前位置：首页 > news >正文

如何在 Rust 脚本中嵌入 Cargo 依赖：cargo-script 完全指南

news 2026/7/5 20:55:37

如何在 Rust 脚本中嵌入 Cargo 依赖：cargo-script 完全指南

【免费下载链接】cargo-scriptCargo script subcommand项目地址: https://gitcode.com/gh_mirrors/ca/cargo-script

想在 Rust 脚本中快速使用第三方库吗？cargo-script 正是你需要的终极工具！这个强大的 Cargo 子命令让你能够像编写脚本一样运行 Rust 代码，同时充分利用 Cargo 丰富的包生态系统。本文将为你提供 cargo-script 的完整使用指南，帮助你快速上手这个高效的 Rust 脚本工具。

🚀 cargo-script 是什么？

cargo-script 是一个专为 Rust 开发者设计的 Cargo 子命令，它允许你将 Rust 代码像脚本一样运行。与传统的 Rust 项目不同，使用 cargo-script 你不需要创建完整的 Cargo 项目结构，只需一个简单的.rs文件就能直接运行包含依赖的 Rust 代码。

这个工具的核心优势在于它能读取嵌入在 Rust 脚本中的 Cargo 清单信息，自动处理依赖管理，并缓存编译结果以加速后续执行。无论是快速原型开发、一次性数据处理任务，还是自动化脚本编写，cargo-script 都能大幅提升你的工作效率。

📦 快速安装方法

安装 cargo-script 非常简单，只需一条命令：

cargo install cargo-script

如果你已经安装过，可以使用以下命令更新到最新版本：

cargo install --force cargo-script

安装完成后，你就可以通过cargo script命令来运行 Rust 脚本了。注意：cargo-script 需要 Rust 1.11 或更高版本才能构建。

🎯 三种核心使用模式

1. 运行完整脚本文件

这是 cargo-script 最基本的使用方式。创建一个包含 Cargo 依赖的 Rust 脚本文件，然后直接运行它：

// hello.rs // cargo-deps: time="0.1.25" extern crate time; fn main() { println!("当前时间: {}", time::now().rfc822z()); }

运行脚本：

cargo script hello.rs

cargo-script 会自动下载并编译依赖，然后执行脚本。第一次运行可能需要一些时间编译依赖，但后续运行会直接使用缓存，速度极快！

2. 内联表达式执行

不想创建文件？cargo-script 支持直接从命令行运行 Rust 表达式：

cargo script --dep time --expr "extern crate time; time::now().rfc822z().to_string()"

更简洁的写法：

cargo script -d time -e "time::now().rfc822z().to_string()"

表达式的结果会自动使用 Debug 格式化器打印出来。你可以使用-d或--dep参数添加依赖，-x或--extern参数注入 extern crate 声明。

3. 流过滤器模式

cargo-script 还能作为命令行管道过滤器使用，非常适合文本处理任务：

cat data.txt | cargo script --loop "|line| println!(\"处理: {}\", line.trim())"

或者带行号的版本：

cat data.txt | cargo script --count --loop "|line, n| println!(\"{:>4}: {}\", n, line.trim())"

🔧 高级功能详解

嵌入依赖的多种写法

cargo-script 支持多种方式在脚本中声明依赖：

单行注释方式（最简单）：

// cargo-deps: time="0.1.25", serde="1.0"

文档注释块方式（支持完整 Cargo.toml 语法）：

//! ```cargo //! [dependencies] //! time = "0.1.25" //! serde = "1.0" //! [features] //! default = ["time"] //! ```

环境变量支持

cargo-script 为脚本提供了一些有用的环境变量：

CARGO_SCRIPT_BASE_PATH：用于解析相对依赖路径的基础路径
CARGO_SCRIPT_PKG_NAME：生成的包名
CARGO_SCRIPT_SAFE_NAME：脚本文件名（不含扩展名）
CARGO_SCRIPT_SCRIPT_PATH：脚本的绝对路径

模板系统

cargo-script 内置了模板系统，让你可以创建可复用的代码模板。查看现有模板：

cargo-script templates list

创建自定义模板只需在模板目录中添加 Rust 文件，使用#{prelude}和#{script}作为占位符。

🛠️ 实用命令行选项

cargo-script 提供了丰富的命令行选项来满足不同需求：

--bench：编译并运行基准测试（需要 nightly 工具链）
--debug：构建调试版本而非优化版本
--features <features>：传递 Cargo 特性
--force：强制重新构建脚本
--gen-pkg-only：仅生成 Cargo 包而不编译运行
--test：编译并运行测试

💡 最佳实践技巧

跨平台脚本编写

为了让脚本在 UNIX 和 Windows 上都能直接执行，建议同时使用 hashbang 和.crs扩展名：

#!/usr/bin/env run-cargo-script // cargo-deps: clap="2.23" extern crate clap; use clap::{App, Arg}; fn main() { let matches = App::new("我的脚本") .arg(Arg::with_name("输入") .help("输入文件") .required(true) .index(1)) .get_matches(); println!("处理文件: {:?}", matches.value_of("输入")); }

保存为myscript.crs并赋予执行权限，就能直接运行了！