salsa-rs/salsa

说明与用途

**项目简介**
salsa-rs/salsa 是一个基于 Rust 的通用增量计算框架，支持按需（on‑demand）和增量化（incrementalized）地执行查询。它的设计受到了 Adapton、Glimmer 以及 Rust 编译器（rustc）查询系统的启发，能够在大量相互依赖的计算中自动缓存并仅在输入变化时重新计算受影响的部分。

**价值**

• **高效增量更新**：在数据或配置变化时，只重新计算受影响的查询，避免全量重算，显著提升响应速度。
• **抽象统一的查询模型**：通过声明式的 query 宏，开发者可以像写普通函数一样定义依赖关系，框架负责管理缓存和调度。
• **Rust 生态友好**：全 Rust 实现、零运行时开销、无 GC，天然兼容 Cargo、async/await 等生态工具，适合编译器、IDE、游戏引擎、数据流处理等需要高性能增量计算的场景。

**典型接入方式**

1. **在 Cargo.toml 中添加依赖**

   [dependencies]
   salsa = "0.16"

1. **定义数据库（Database）和查询**

   #[salsa::database]
   #[derive(Default)]
   struct MyDatabase {
       storage: salsa::Storage<Self>,
   }

   #[salsa::query_group(MyQueries)]
   trait MyQueries {
       #[salsa::input]
       fn source(&self, id: u32) -> String;

       #[salsa::invoke(my_compute)]
       fn computed(&self, id: u32) -> usize;
   }

   fn my_compute(db: &dyn MyQueries, id: u32) -> usize {
       let src = db.source(id);
       // 这里写实际的计算逻辑
       src.len()
   }

1. **在业务代码中创建数据库实例并使用**

   let mut db = MyDatabase::default();
   db.set_source(1, "hello".into());
   let len = db.computed(1); // 首次计算
   let len2 = db.computed(1); // 直接命中缓存

1. **增量化使用**：当 source 输入改变后，只有依赖 computed 的查询会被重新调度，其他查询保持缓存。

**生产可用性**

• **成熟度**：截至 2026‑06‑26，项目拥有约 2.9k ⭐、214 forks，活跃维护，最近一次提交在同日，社区活跃度良好。
• **适用场景**：非常适合作为内部原型、工具链、IDE 插件或业务系统的增量计算层；在对性能和一致性要求高、且可以接受一定的学习成本时，也可用于生产环境。
• **风险与注意事项**
• 框架的接入点主要是代码层面的 Database 与 query 定义，缺少即插即用的配置或插件式集成，需要开发者自行设计数据库结构。
• 依赖的 Rust 版本和编译器特性需保持同步，升级时需检查兼容性。
• 对于极其复杂的依赖图，调试缓存失效可能需要额外的日志或自定义 debug 钩子。

**结论**：salsa-rs/salsa 在需要高效增量计算的 Rust 项目中提供了强大的抽象和性能优势。若项目已有 Rust 代码基并能够投入一定的集成工作，它完全可以在生产环境中使用；否则建议先在原型或内部工具中验证其集成成本与收益后再决定是否推广。

实际用途

salsa-rs/salsa may be useful when its README and activity match a concrete workflow.

限制与审查说明

Medium: useful for prototypes or internal workflows, with dependency and maintenance checks before production.