SuperAPI AI 工具集

rust

编程与开发

查看项目

更新于 11-08 23:21

技能介绍

该技能面向使用 Rust 编写服务、数据 CLI 和原生扩展的开发者,核心目标是保持简单、显式依赖、以管道组合、并向标准输出输出 JSON。

在依赖与状态管理方面,要求依赖显式化:构造函数接收所需参数,不使用全局状态,也不为数据库连接池或客户端等对象使用 lazy_static/OnceLock 单例。

在错误处理方面,主张让错误携带上下文:库的错误类型使用 thiserror,应用边界处使用 anyhow 并通过 .context("what was being attempted") 说明当时正在尝试的操作。

在并发模型方面,服务使用 Tokio,计算使用线程:每个 Web 服务从第一天起就基于 Tokio + axum;CPU 密集型工作(数据并行转换、批处理任务、无网络 I/O 的 CLI)使用线程或 rayon;在服务内部,将阻塞或 CPU 繁重的工作交给 spawn_blocking(或 rayon 线程池),以免拖慢运行时。

在开发流程方面,以 mise 作为入口,提供 cargo build、cargo test、cargo clippy,以及使用 bacon 或 watchexec 并输出到 logs/ 的开发任务。

参考资料 references/async.md 介绍 Tokio 的执行模型、与 Go 的对比以及取消机制:为何任何 future 都可能停在任意 .await 处、由此产生的缺陷以及可避免这些缺陷的模式;建议在编写或审查异步代码前阅读。

限制与缺失:资料未提供具体的安装命令、依赖版本、完整示例代码、平台要求或性能数据,这些内容暂未提供。