eris

eris

[![GoDoc][doc-img]][doc] [![Build][ci-img]][ci] [![GoReport][report-img]][report] [![Coverage Status][cov-img]][cov] eris 包是一个错误处理库,具有可读的堆栈跟踪和灵活的格式化支持。 go get GitHub.com/rotisserie/eris

• 为什么要切换到 eris
• 使用 eris
  • 创建错误
  • 包装错误
  • 格式化和记录错误
  • 解释 eris 堆栈跟踪
  • 反转堆栈跟踪和错误输出
  • 检查错误
  • 使用自定义分隔符进行格式化
  • 编写自定义输出格式
  • 将错误跟踪发送到 Sentry
• 与其他包（例如 pkg/errors）的比较
  • 错误格式化和堆栈跟踪
• 迁移到 eris
• 贡献

为什么你应该转用 eris 这个包的灵感来自于一个简单的问题:如果你可以修复一个错误而不必浪费时间去复制问题或翻查代码,那该多好?考虑到这一点,这个包旨在通过错误包装、堆栈跟踪和输出格式化,让你更好地控制错误处理。示例生成了下面的输出,模拟了一个现实的错误处理场景,并展示了如何通过最小的努力包装和记录错误。这个特定的错误是因为用户尝试访问无法找到的文件,输出显示了从调用堆栈顶部到源代码的清晰路径。

如果您使用过 pkg/errors 或 xerrors,那么本包中的许多方法会显得很熟悉,但 eris 在错误包装和解包过程中采用了一些额外的技巧,大大提高了可读性。