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

Cargo-script 入门指南：如何在 Rust 中像脚本一样运行代码

news 2026/7/5 19:05:53

Cargo-script 入门指南：如何在 Rust 中像脚本一样运行代码

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

想要快速测试 Rust 代码片段而不想创建完整的 Cargo 项目吗？🚀 cargo-script 正是你需要的终极工具！这个强大的 Rust 脚本运行器让你能够像编写 Python 或 Bash 脚本一样编写和运行 Rust 代码，同时还能利用 Cargo 丰富的包生态系统。本文将为你提供完整的 cargo-script 入门指南，帮助你快速掌握这个实用的 Rust 开发工具。

什么是 Cargo-script？🤔

Cargo-script是一个 Cargo 子命令，专门设计用于让开发者能够快速、轻松地运行 Rust "脚本"，同时充分利用 Cargo 的包生态系统。它解决了 Rust 开发中的一个常见痛点：当你只想快速测试一个小功能或编写一个简单的工具时，创建完整的 Cargo 项目显得过于繁琐。

想象一下，你有一个简单的想法需要验证，或者需要快速处理一些数据。使用 cargo-script，你只需要一个.rs文件，就能像运行脚本一样执行 Rust 代码，无需Cargo.toml，无需创建项目目录结构，一切都变得如此简单！

快速安装步骤 📦

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

cargo install cargo-script

如果你已经安装过，想要更新到最新版本：

cargo install --force cargo-script

安装完成后，你就可以通过cargo script命令来使用它了。注意命令中缺少连字符 - 这是正确的用法！

三种使用方式详解 🎯

1. 运行 Rust 脚本文件

这是 cargo-script 最基本也是最常用的功能。假设你有一个简单的hello.rs文件：

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

运行它只需要：

cargo script hello.rs # 或者省略文件扩展名 cargo script hello

更棒的是，你可以在脚本中直接指定依赖项：

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

cargo-script 会自动处理依赖下载和编译，让你专注于代码本身。

2. 命令行表达式求值

不想创建文件？直接在命令行中运行 Rust 表达式：

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

使用简写形式更便捷：

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

3. 流过滤器模式

cargo-script 还可以作为流处理器使用，非常适合处理文本数据：

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

带行号计数的版本：

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

高级功能探索 🔧

智能缓存机制

cargo-script 会自动缓存编译结果。当你第一次运行脚本时，它会编译所有依赖项。后续运行相同的脚本时，如果没有修改，它会直接使用缓存的可执行文件，大大提高了执行速度。

支持单元测试和基准测试

你甚至可以在脚本中运行测试：

cargo script --test your_script.rs

或者在 nightly 工具链上运行基准测试：

cargo script --bench your_script.rs

自定义模板系统

创建可重用的代码模板来简化常用模式：

// 保存为 ~/.cargo-script/templates/mytemplate.rs // cargo-deps: itertools="0.6.2" #![allow(unused_imports)] #{prelude} extern crate itertools; use std::io::prelude::*; use std::mem; fn main() { let result = { #{script} }; println!("{:?}", result); }

使用自定义模板：

cargo script -t mytemplate -e "mem::size_of::<Box<Read>>()"

跨平台支持 🌍

UNIX 系统（Linux/macOS）

在 UNIX 系统上，你可以创建可执行的 Rust 脚本：

#!/usr/bin/env run-cargo-script // cargo-deps: time="0.1.25" extern crate time; fn main() { println!("Current time: {}", time::now().rfc822z()); }

保存为可执行文件后，直接运行：./your_script.rs

Windows 系统

Windows 用户可以使用文件关联功能：

cargo-script file-association install

这会将.crs扩展名与 cargo-script 关联，让你可以像运行.exe文件一样运行.crs脚本。

环境变量配置 ⚙️

cargo-script 提供了几个有用的环境变量：

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

实用技巧与最佳实践 💡

1. 性能优化

默认情况下，如果构建时间少于 2 秒且成功，cargo-script 会抑制 Cargo 的输出。这可以避免不必要的输出干扰。如果需要查看完整输出，可以使用--verbose标志。

2. 调试模式

构建调试版本而非优化版本：

cargo script --debug your_script.rs

3. 强制重新编译

如果遇到缓存问题或需要强制使用不同的工具链重新编译：

cargo script --force your_script.rs

4. 仅生成包

只想查看 cargo-script 生成的完整 Cargo 包结构？

cargo script --gen-pkg-only your_script.rs

常见问题解答 ❓

Q: cargo-script 支持哪些 Rust 版本？

A: cargo-script 需要 Rust 1.11 或更高版本。在 0.2 版本之前支持 Rust 1.4+。

Q: 如何查看所有可用选项？

A: 运行cargo script --help查看完整选项列表。

Q: 能否在脚本中使用外部 crate？

A: 当然可以！使用// cargo-deps:注释指定依赖，或者使用代码块格式的 Cargo 清单。

Q: 缓存文件存储在哪里？

A: 缓存文件存储在 Cargo 的脚本缓存目录中，通常位于~/.cargo/script-cache/（Linux/macOS）或%USERPROFILE%\.cargo\script-cache\（Windows）。

实际应用场景 🚀

场景 1: 快速数据转换

// cargo-deps: csv="1.0", serde="1.0", serde_derive="1.0" #[macro_use] extern crate serde_derive; extern crate csv; #[derive(Debug, Deserialize)] struct Record { name: String, age: u32, city: String, } fn main() { let mut rdr = csv::Reader::from_reader(std::io::stdin()); for result in rdr.deserialize() { let record: Record = result.unwrap(); println!("{:?}", record); } }

场景 2: 简单的 HTTP 请求

// cargo-deps: reqwest="0.9" extern crate reqwest; fn main() { let response = reqwest::get("https://api.github.com/users/rust-lang") .unwrap() .text() .unwrap(); println!("{}", response); }

场景 3: 文件批量处理

// cargo-deps: walkdir="2.2" extern crate walkdir; use std::fs; use walkdir::WalkDir; fn main() { for entry in WalkDir::new(".") .into_iter() .filter_map(|e| e.ok()) .filter(|e| e.path().extension().map_or(false, |ext| ext == "rs")) { println!("Found Rust file: {:?}", entry.path()); } }