std::expected 通过 and_then、or_else、transform、map_error 及多态错误封装，实现零开销、类型安全的链式错误分发与处理。
如果您在构建复杂数据处理流程时需要将多个可能失败的操作串联执行，并确保任一环节出错即终止并透传错误上下文，则 std::expected 提供了零开销、类型安全的链式错误分发能力。以下是实现此目标的具体方法：
一、使用 and_then 构建线性错误传播链
and_then 是 std::expected 的核心链式操作符，它仅在当前对象持有成功值时调用传入的函数，且该函数必须返回另一个 std::expected 类型；若当前为错误状态，则跳过函数调用并直接透传原始错误。这种机制天然支持“短路式”错误分发，避免嵌套判断。
1、定义每个阶段的处理函数，统一返回 std::expected
2、确保各函数的错误类型（E）一致，例如全部使用 std::string 或自定义枚举类 file_error。
立即学习“C++免费学习笔记（深入）”；
3、将函数按逻辑顺序以点号链式调用：result = stage1().and_then(stage2).and_then(stage3)。
4、编译器会自动扁平化嵌套结构，最终 result 类型与首项返回类型一致，不会出现 std::expected<:expected>,E>。
二、通过 or_else 实现错误分类与条件恢复
or_else 用于在错误路径上执行分支处理，它接收一个以 const E& 为参数的可调用对象，返回一个新的 std::expected。该机制允许对特定错误码执行降级策略、日志记录或转换为更高级别语义错误，从而实现细粒度错误分发。
1、在 and_then 链中某环节后追加 .or_else([](const std::string& err) { ... })。
2、在 lambda 内部使用 if-else 或 switch 对 err 内容进行匹配，例如判断是否包含 "permission_denied"。
3、对匹配的错误构造新的 std::unexpected，如 std::unexpected("access denied: insufficient privileges")。
4、对不匹配的错误原样返回 std::unexpected(err)，维持错误透传行为。
三、组合 transform 与 map_error 实现双路径无副作用映射
transform 作用于成功值路径，map_error 作用于错误值路径，二者均不改变 std::expected 的状态，仅对内部值做纯函数式转换。它们适用于需统一修饰输出格式或标准化错误消息的场景，是错误分发前的预处理层。
1、调用 .transform([](int x) { return x * 2; }) 将成功结果乘以 2，不影响错误分支。
2、调用 .map_error([](const std::string& e) { return "[IO] " + e; }) 为所有错误消息添加前缀。
3、可连续调用多次 transform 或 map_error，顺序执行且无中间临时对象开销。
4、注意 transform 返回值类型必须与原 success 类型兼容，否则编译失败。
四、封装多态错误类型以支持跨模块错误路由
当系统存在多个子模块且各自定义独立错误类型时，直接链式调用会因 E 类型不一致而中断。此时应统一抽象为 std::variant 或继承体系，使 and_then 链能持续传递并由终端集中 dispatch。
1、定义公共错误基类 error_category，各模块错误类型继承自它。
2、所有函数返回 std::expected
3、在链尾调用 .and_then([](auto val) { return handle_final_result(val); })，其中 handle_final_result 接收具体类型并执行分支 dispatch。
4、避免在中间环节做 dynamic_cast，改用 visit(std::variant) 或虚函数表分发，保证零运行时开销。
五、嵌入 RAII 资源生命周期与 expected 错误流协同
std::expected 本身不管理资源，但可与 RAII 类型（如 std::fstream、std::unique_lock）结合，在错误分发链中显式表达资源获取失败的语义，避免异常介入破坏控制流。
1、将资源构造封装为返回 std::expected
2、在 and_then 链中将其作为首节点：open_file(p).and_then(read_content).and_then(parse_json)。
3、ResourceType 必须满足可移动性，且其析构函数不得抛出异常，以符合 noexcept 链式调用要求。
4、若需延迟释放资源，将 ResourceType 包裹进 std::shared_ptr 或自定义句柄类，确保 and_then 回调退出后资源仍有效。
