Uber Go 语言编程规范:错误包装

Uber Go 语言编程规范 Uber Go 语言编程规范 相信很多人前两天都看到 Uber 在 github 上面开源的 Go 语言编程规范了,原文在这里:https://github.com/uber-go/guide/blob/master/style.md 。我们今天就来简单了解一下国外大厂都是如何来写代码的。行文仓促,错误之处,多多指正。另外如果觉得还不错,也欢迎分享给更多的人。 文章目录Uber Go 语言编程规范... 阅读详情

如果一个函数或方法调用失败时,有三种方式来传播错误:

  • 如果没有额外的上下文环境需要添加并且你想保持原始的错误类型的话,请返回原始的错误。
  • 通过"pkg/errors".Wrap添加上下文环境,以至于错误消息能够提供更多的上下文信息,并且"pkg/errors".Cause可以用来提取原始的错误。
  • 如果调用者无需断言和处理指定的错误的情况下,请使用fmt.Errorf

强烈建议在可能的情况下,请添加上下文,这样就不会出现“connection refused”这样模糊的错误,你会得到更多有用的错误描述信息,例如“call service foo: connection refused”。

当为返回的错误添加上下文时,避免使用像“failed to”这样的短语来保持上下文的简洁,这些短语陈述了明显的错误,并在错误通过堆栈溢出时堆积起来。

Bad

s, err := store.New()
if err != nil {
 //没有额外的上下文环境需要添加
    return fmt.Errorf(
        "failed to create new store: %s", err)
}

//错误传播的话,容易操作错误信息的模糊
//failed to x: failed to y: failed to create new store: the error

Good

s, err := store.New()
if err != nil {
    return fmt.Errorf(
        "new store: %s", err)
}

//错误传播的话,错误消息简单明了
//x: y: new store: the error

一个errors.Wrap 的例子:

package main

import (
	"fmt"

	"github.com/pkg/errors"
)

func main() {
	cause := errors.New("whoops")
	err := errors.Wrap(cause, "oh noes")
	fmt.Println(err)

}


Output:

oh noes: whoops

一旦错误被发送至另外一个系统,就应该明确此消息是错误消息(例如使用err标记,或在日志中以”Failed”为前缀)。

另请参见 Don't just check errors, handle them gracefully. 不要只是检查错误,要优雅地处理错误

Uber 公司推出的 GoLang 编程规范 如果不是lib库,就需要增加所需的上下文信息,不然就会出现 "connection refused" 这样非常 模糊的错误,理论上应该添加上下文,来得到这样的报错信息:"call service foo: connection refused"。最好的情况下,编译器会直接报错,最糟糕的情况下,这样的代码会引入难以排查的bug。如果结构体中包含mutex,在使用结构体的指针时,mutex应该是结构体的非指针字段,也不要把mutex内嵌到结构体中,即使结构体是非导出类型。尽管编写内嵌类型已实现的方法是乏味的。 阅读详情

相关推荐

Go-werr-错误包装器在Go中为错误类型创建一个包装器

werr - 错误包装器在Go中为错误类型创建一个包装器,可以捕捉文件,行和堆栈被调用的地方。

Go错误处理实践

Go标准库中error类型是一个接口类型,在}只要实现了Error()方法的类型都可以作为error返回,它将错误消息以字符串的形式返回。

张氏小毛驴的博客 1671

直流有刷电机三环PID控制:从硬件配置到软件调试全解析

本文全面解析了直流有刷电机的三环PID控制技术,涵盖从硬件选型(如驱动板、编码器)到STM32软件配置的全过程。详细阐述了位置环、速度环、电流环的串级协同工作原理与调试方法,并提供了位置式PID算法的C语言实现代码及参数整定技巧,旨在帮助开发者实现精准、稳定的电机运动控制。

weixin_29290963的博客 390

GO 1.20 新功能:多重错误包装

预计将于 2023 年 2 月发布的 Go 1.20 有一个小的变化,对于那些大量使用错误包装的应用程序来说,可能会有效改进它们的错误处理方法。让我们看一下它的用法,但首先,需要简要回顾一下什么是错误包装。如果你已经掌握了可以直接跳到下面的 “Go 1.20 新功能” 部分以获取新的信息。Go 中的错误是实现一个非常简单的接口:typeerrorinterface{ Error()...

Go中国 1396

微信小店推客分销系统源码获取与自研开发全攻略(2025年最新版)

源码选择建议快速试错:选用开源项目(如启航系统),3天可上线基础功能长期布局:购买商业源码授权,重点定制分佣规则与UI交互完全自研:适合年GMV过亿的大型企业,需前置投入风控与合规设计行动清单注册微信开放平台账号,完成视频号机构认证下载开源项目代码,部署本地测试环境联系三家源码供应商,获取合规性审计报告设计三级分佣比例表,通过法律顾问合规审查通过以上路径,可高效构建合规、稳定、高转化的微信小店推客分销系统,抢占2025年视频号电商红利。

2401_85184777的博客 1287

CentOS 7下kkFileView 4.4.0离线部署全攻略(含LibreOffice 7.5配置避坑指南)

本文详细介绍了在CentOS 7环境下离线部署kkFileView 4.4.0的全流程,包括LibreOffice 7.5的配置避坑指南、中文字体解决方案以及企业级运维实践。通过本指南,用户可以在内网环境中快速搭建稳定可靠的文档在线预览服务,提升办公效率。

weixin_28481133的博客 291

Go错误包装

错误包装是将一个错误封装到另一个错误中的过程。假设我们有一个 Web 服务器,它访问数据库并尝试从数据库中获取记录。如果数据库调用返回错误,我们可以决定是包装该错误还是从 Web 服务发送我们自己的自定义错误。

qq497811258的博客 404

python123题目——个税计算器

类型:简单分支。

m0_62488776的博客 5806

Go 中的 error 居然可以这样封装

本文由周浩翻译自:https://medium.com/spectro-cloud/decorating-go-error-d1db60bb9249,ironbox和Tang Ruilin...

EDDYCJY的博客 1989

clang-tidy 使用指南

clang-tidy 需要一个编译数据库来了解如何编译你的代码。编译数据库通常是一个名为 compile_commands.json 的文件。在这个示例中,clang-tidy 会对 test.cpp 文件进行分析,并报告任何潜在的问题。例如,它可能会警告 test 函数中的未使用变量 x。clang-tidy 是一个用于 C++ 代码的静态分析工具,可以帮助你发现代码中的潜在问题和改进点。这将在 build 目录中生成一个 compile_commands.json 文件。

weixin_42244181的博客 2363

嵌入式开发必备:aarch64-linux-gnu-gcc交叉编译工具链保姆级安装指南(含常见错误解决)

本文详细介绍了aarch64-linux-gnu-gcc交叉编译工具链的安装与配置方法,涵盖从系统软件源安装到Linaro二进制包部署的全流程。针对嵌入式开发中常见的依赖错误、版本冲突等问题提供实用解决方案,并分享性能优化技巧与项目集成经验,帮助开发者高效完成ARM64设备的跨平台开发。

yoga7的博客 1035

【go】Go中错误包装的最佳实践与常见误区

nil {return BarError{Err: err} // 使用自定义结构包装// ...return nil特点添加了上下文信息封装了原始错误可以通过类型断言识别这个特定错误类型没有实现标准的错误拆包机制(Go 1.13+的Unwrap)适用场景需要创建特定错误类型来表示特定失败情况调用者需要通过类型断言识别特定错误情况需要自定义错误处理行为。

qq_32641095的博客 655

29. 如何通过 ABAP 代码给 SAP OData 元数据增添注解

我们先看下效果,在 MPC_EXT 类的 DEFINE 方法里编写 ABAP 代码之后,用 Postman 使用 url 访问 OData metadata,在返回的数据里,能看到我们用 ABAP 代码添加的自定义注解。你好,请问可以不可以在odata里面通过什么设置,从而自动给metadata.xml中加上注解,实现value help的功能,还是说每次需要在metadata.xml中修改?的词汇引用,然后为命名空间 com.sap.vocabularies.UI.v1 声明了一个别名。

2007 年 ~ 2025 年,深耕 SAP 技术 18 年 1661

Uber Go 语言编码规范

Uber Go 语言编码规范 中文版

J_Lee 2214

YOLOv11改进策略【模型轻量化】| 替换轻量化骨干网络:ShuffleNet V1

本文记录的是基于ShuffleNet V1的YOLOv11轻量化改进方法研究。ShuffleNet利用和操作降低计算成本,克服了现有先进架构在极小网络中因 1×1 卷积计算成本高而效率低的问题。相比一些传统的网络架构,能更好地。本文配置了原论文中和四种模型,以满足不同的需求。

Limiiiing的博客 1231

SAP B1中文培訓教材_SDK

公司内部培训资料,对开发工具 ,DIAPI, UIAPI,Add-ON有详细解说

Uber Go 编码规范:错误包装与日志记录的最佳实践

在Go语言开发中,错误处理是保证程序健壮性的核心环节。Uber作为全球领先的技术公司,其开源的Go编码规范为开发者提供了系统化的错误处理指南。本文将聚焦错误包装(Error Wrapping)与日志记录两大关键场景,结合[Uber Go规范核心文档](https://link.gitcode.com/i/23a7ca57bacda8d404dd37a25e07b0e7),通过实战案例解析如何构建清...

gitblog_00941的博客 1080

ssm框架搭建

这个是一个在idea上成功跑起来的ssm框架项目,保存在这里方便以后使用直接下载

【转载】Uber Go语言编码规范

文章目录Uber Go语言编码规范一. 介绍二. 指导原则指向interface的指针接收器(receiver)与接口零值Mutex是有效的在边界处拷贝Slices和Maps接收Slices和Maps返回slices或maps使用defer做清理Channel的size要么是1,要么是无缓冲的枚举从1开始错误类型错误包装(Error Wrapping)处理类型断言失败不要panic使用go.ube...

问题不大 2197

锂电池充电器电路设计 里面有电路

锂电池充电器电路设计 里面有电路 3.7V升压到5V电路设计。

STM32F407中文手册

STM32f407中文手册 本参考手册面向应用开发人员,提供有关使用 STM32F405xx/07xx、STM32F415xx/17xx、 STM32F42xxx 和 STM32F43xxx 微控制器存储器与外设的完整信息。STM32F405xx/07xx、STM32F415xx/17xx、STM32F42xxx 和 STM32F43xxx 构成一个微 控制器系列,各产品具有不同的存储器大小、封装和外设。有关订购信息以及器件的机械与电气特性,请参见数据手册。有关 ARM Cortex™-M4F 内核的信息,请参见《Cortex™-M4F 技术参考手册》。

值得参考的golang语言开发规范:Uber Go 语言编码规范,一些优秀的技巧可以提升代码的质量、避免代码缺陷和bug漏洞

值得参考的golang语言开发规范:Uber Go 语言编码规范,一些优秀的技巧可以提升代码的质量、避免代码缺陷和bug漏洞。

代码讲故事 1113

Uber 公司Golang编程规范【翻译】

引言 样式是支配我们代码的惯例。 术语“样式”有点用词不当,因为这些约定不仅仅涵盖那些可以由gofmt替我们处理的源文件格式。 本指南的目的是通过详细描述在Uber编写Go代码的注意事项来管理这种复杂性。 这些规则的存在是为了使代码库易于管理,同时仍然允许工程师有效地使用Go语言功能。 该指南最初由Prashant Varanasi和Simon Newton编写,目的是使一些同事快速使用Go。 多...

后端开发 1740

uber_go_guide_tw:Uber Go 语言编写规范繁体中文翻译

uber_go_guide_tw:Uber Go 语言编写规范繁体中文翻译 项目介绍 Uber Go 语言编写规范是由Uber公司开源的一套用于指导Go语言编写的最佳实践。这些规范旨在帮助开发者编写易于管理、高效且安全的Go代码。该项目在GitHub上开源,已经吸引了众多开发者的关注和贡献。 项目技术分析 uber_go_guide_tw项目包含了Uber公司内部使用的Go语言编写规范,这些规范不...

gitblog_00243的博客 890

uber关于go语言规范

本文老子github上的Uber对于go语言的规范,从中我们可以避免在开发过程中的坑. 地址:https://github.com/xxjwxc/uber_go_guide_cn Go 语言编码规范 Uber是一家美国硅谷的科技公司,也是 Go 语言的早期 adopter。其开源了很多 golang 项目,诸如被 Gopher 圈熟知的zap、jaeger等。2018 年年末 Uber 将内部的Go 风格规范开源到 GitHub,经过一年的积累和更新,该规范已经初具规模,并受到广大 ...

FindHuni的博客 658
上一篇: Uber Go 语言编程规范:错误类型
下一篇: Uber Go 语言编程规范:处理类型断言失败
DreamCatcher
博客等级 码龄20年 23粉丝 151原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

DreamCatcher

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值