rust

Rust

概述

Rust 是一种系统编程语言，专注于安全性、并发性和性能。所有权系统无需垃圾回收即可保证内存安全，而类型系统会在编译时确保线程安全。

适用场景： 系统编程、Web 服务（axum）、CLI 工具（clap）、终端 UI（ratatui）、WebAssembly、性能关键型应用，以及任何需要内存安全且无需运行时开销的场景。

不适用场景： 更看重编译速度而非安全性的快速原型开发、简单的脚本任务，以及团队缺乏 Rust 经验且工期紧张的项目。

快速参考

模式	API / 工具	要点
所有权转移	let b = a;	a 会被移动，之后不可再用
借用	&T / &mut T	一个可变引用或多个不可变引用
生命周期标注	fn f<'a>(x: &'a str) -> &'a str	将输出生命周期与输入绑定
错误传播	? 运算符	转换并传播错误
自定义错误	thiserror::Error derive	具有 Display 的结构化错误类型
临时错误	anyhow::Result<T>	为应用程序提供上下文链
异步运行时	#[tokio::main]	异步程序的入口点
启动任务	tokio::spawn(async { })	并发执行异步任务
HTTP 路由器	axum::Router::new().route(...)	使用提取器组合路由
提取器	Json<T>, Path<T>, State<T>	类型安全的请求解析
序列化	#[derive(Serialize, Deserialize)]	使用 serde 派生与格式无关的实现
CLI 解析	#[derive(Parser)]	用于解析参数的 clap derive API
TUI 渲染	terminal.draw(|f| { })	ratatui 即时模式渲染
基准测试	criterion::Criterion	统计基准测试框架
依赖项审计	cargo deny check	审计许可证、漏洞和来源
二进制发布	cargo dist init	跨平台二进制分发
更新日志	release-plz update	自动更新 semver 版本和更新日志

常见错误

错误	正确做法
返回局部变量的引用	返回拥有所有权的类型，或使用生命周期参数
在库代码中使用 unwrap()	返回 Result，由调用方决定
为满足借用检查器而调用 clone()	重构代码以避免借用冲突
在异步上下文中阻塞	使用 tokio::task::spawn_blocking
未使用同步机制的共享可变状态	使用 Arc<Mutex<T>> 或通道
可用 &str 时使用 String	在函数参数中接受 &str
忽略 must_use 警告	处理警告，或使用 let _ = 显式丢弃
枚举变体过大	将较大的变体装箱以减小整体体积
特征中的 async fn 未指定约束	添加 Send 约束，或使用 async-trait crate
异步测试缺少 #[tokio::test]	使用 #[tokio::test]，而不是 #[test]

任务委派

• 代码探索：使用 Explore Agent
• 架构审查：使用 Task Agent
• 代码审查：委派给 code-reviewer Agent

如果有 docker 技能，请将多阶段容器构建模式委派给它。 如果有 github-actions 技能，请将 CI 流水线配置委派给它。 如果有 openapi 技能，请将 API 规范和代码生成委派给它。

参考资料

• 所有权、借用、生命周期和类型系统模式
• 使用 Result、Option、thiserror 和 anyhow 处理错误
• 使用 Tokio 运行时进行异步编程和并发处理
• 使用 axum、tower 和 sqlx 构建 Web API 和后端
• 使用 ratatui 和 crossterm 构建终端用户界面
• 使用 clap、config 和信号处理构建 CLI 应用
• 测试模式和 criterion 基准测试
• 使用 cargo-deny、cargo-dist 和 release-plz 构建发布流水线