iex-rs/lithium

说明与用途

**项目简介（2‑3 句话）**
iex-rs/lithium 是一个面向 Rust 的轻量级异常处理库，提供类似 try/catch 的语法糖和可组合的错误传播机制，旨在让错误处理更简洁、可读。库体积小、依赖少，适合在对二进制体积和编译速度有严格要求的项目中使用。

---

价值

1. **简化错误处理**：通过宏和 trait 扩展，能够在不引入 anyhow、thiserror 等重量级库的情况下，实现链式错误传播和上下文包装。
2. **零运行时开销**：所有异常逻辑在编译期展开，运行时仅产生普通 Result，对性能几乎没有影响。
3. **易于组合**：提供 ResultExt、TryCatch 等工具，使不同模块的错误类型能够统一转换，降低跨模块错误适配成本。
4. **轻量依赖**：仅依赖 Rust 标准库（可选 alloc），对项目的依赖树几乎没有膨胀。

典型接入方式

# Cargo.toml
[dependencies]
lithium = "0.3"

use lithium::{try_catch, ResultExt};

fn parse_num(s: &str) -> Result<i32, MyError> {
    s.parse::<i32>()
        .map_err(|e| MyError::Parse(e.to_string()))
        .context("parsing integer")
}

fn main() -> Result<(), MyError> {
    try_catch! {
        let n = parse_num("42")?;
        println!("Number: {}", n);
    } else |e| {
        eprintln!("Error occurred: {}", e);
    }
    Ok(())
}

1. **添加依赖**：在 Cargo.toml 中加入 lithium。
2. **导入宏/trait**：在需要的模块 use lithium::{...}。
3. **使用 ResultExt::context** 为错误添加上下文，或使用 try_catch! 宏实现类似 try/catch 的块结构。
4. **与已有错误类型兼容**：通过实现 From/Into 或使用 ResultExt::map_err，可以无缝接入项目已有的错误枚举。

生产可用性

| 维度 | 评估 |
|------|------|
| **成熟度** | 2026-07-05 最近一次更新，星标 102，fork 3，社区关注度一般。代码量小，审计成本低。 |
| **适用场景** | 原型、内部工具、对二进制体积敏感的服务（如嵌入式、WebAssembly）以及需要统一错误上下文的中大型 Rust 项目。 |
| **风险** | - 集成路径不够明确，官方文档较简略，需要自行阅读源码确认宏展开行为。<br>- 仍在活跃维护，但缺少大规模生产案例的公开报告。 |
| **建议** | 在 **原型或内部系统** 中先行试点：<br>1. 添加依赖并跑单元测试，确认编译时间和二进制增量符合预期。<br>2. 通过 cargo audit 检查安全/许可证风险。<br>3. 若无额外运行时开销且错误信息满足需求，可逐步推广到生产服务。 |
| **维护成本** | 代码量极小，升级冲击低；但建议锁定在 0.x 兼容范围，避免突发的重大改动。 |

**结论**：iex-rs/lithium 在保持极低依赖和运行时开销的前提下，提供了更友好的错误处理体验，适合对体积和性能有严格要求的 Rust 项目。生产环境使用前建议进行一次小范围的集成验证，确认宏行为与项目错误模型匹配后再正式上线。

实际用途

iex-rs/lithium 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.