知识卡片

普通读书笔记卡 · 4545.g.11.c.1.e.8.a

错误上下文可结构化而非猜文字

理解等级:中级

error只要求Error() string,因此基础错误可只带描述,需要程序决策的上下文则可由明确错误类型和方法提供。包装可补充操作语境,同时按合同保留可检视的原因。

描述文本服务人阅读,不应悄悄变成稳定机器协议。导出字段、错误类型或可解包原因会形成调用方依赖,设计时要决定哪些信息属于公开API,哪些只适合日志。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • · 查看原书依据

      error接口是错误值提供者与错误值检视者之间的契约。error接口的实现者负责提供错误上下文供负责错误处理的代码使用。这种错误上下文与error接口类型的分离体现了Go设计哲学中的“正交”理念。

    参考来源

    - 位置:《Go语言精进之路 _ 从新手到高手的编程思想,方法和技巧 = Go programming from beginners》第37章《37.1 构造错误值》(来源项目book-sources:extracted/Go语言精进之路 _ 从新手到高手的编程思想,方法和技巧 = Go programming from beginners/_epub-src/Text/Chapter37_0001.xhtml;spine 159,归一字符[1913,2011)) - 结论依据:原文errors.New/fmt.Errorf与net.OpError例支持描述和结构化上下文分离。 - 原始内容:error接口是错误值提供者与错误值检视者之间的契约。error接口的实现者负责提供错误上下文供负责错误处理的代码使用。这种错误上下文与error接口类型的分离体现了Go设计哲学中的“正交”理念。