Uber Go 语言编程规范:错误类型

深入解析go依赖注入库go.uber.org/fx 后面更新采用肝一篇go官方源码,肝一篇框架源码形式,伤肝->护肝,如果你喜欢就点个赞吧。官方源码比较伤肝(* ̄︶ ̄)。 1依赖注入 初识依赖注入来自开源项目Grafana 的源码,该项目框架采用依赖注入方式对各结构体字段进行赋值。DI 依赖注入包为https://github.com/facebookarchive/inject,后面我会专门介绍这个包依赖注入的原理。不过今天的主角是它:https://github.com/uber-go/fx。 该包统一采用构造函数Newxx()形式进行依赖注 阅读详情

在Golang中有多种声明错误的方式:

当返回错误时,请考虑以下内容以确定最佳选择:

  • 如果是一个简单的错误并且不需要额外的信息,那么 errors.New 就可以满足。
  • 如果客户端需要检测并且处理错误,那么你需要自定义一个错误类型,并且实现Error()方法。
  • 如果你需要传播下游函数返回的错误,那么你需要对此类错误进行相应的包装。
  • 其他情况,fmt.Errorf即可满足需求

如果客户端需要检测错误,并且您已经使用errors.New创建了一个简单的错误,请使用var定义有一个错误变量。

Bad

// package foo
//直接返回一个error
func Open() error {
  return errors.New("could not open")
}

// package bar

func use() {
  //直接返回一个错误
  if err := foo.Open(); err != nil {
  //通过的错误的描述信息进行判断
    if err.Error() == "could not open" {
      // handle
    } else {
      panic("unknown error")
    }
  }
}

Good

// package foo

//在foo包中,定义一个ErrCouldNotOpen 变量,并且此变量是可以导出的(首字母大写)
var ErrCouldNotOpen = errors.New("could not open")

func Open() error {
 //直接返回错误变量
  return ErrCouldNotOpen
}

// package bar
//在bar包中,
if err := foo.Open(); err != nil {
//根据变量类型进行判断
  if err == foo.ErrCouldNotOpen {
    // handle
  } else {
    panic("unknown error")
  }
}

如果你有一个错误,客户端可能需要进行检测判断,而且你期望还要添加更多的信息(例如,它不是一个静态的字符串),此种情况,你需要一个自定义的错误类型。

Bad

func open(file string) error {
//直接返回错误
  return fmt.Errorf("file %q not found", file)
}

func use() {
  if err := open("testfile.txt"); err != nil {
    //根据错误内容进行判断
    if strings.Contains(err.Error(), "not found") {
      // handle
    } else {
      panic("unknown error")
    }
  }
}

Good

//自定义一个错误类型
type errNotFound struct {
  file string
}

//实现Error()方法
func (e errNotFound) Error() string {
  return fmt.Sprintf("file %q not found", e.file)
}

//直接返回自定义的错误类型,并且实时修改错误内容
func open(file string) error {
  return errNotFound{file: file}
}

func use() {
  if err := open("testfile.txt"); err != nil {
    //通过类型断言
    if _, ok := err.(errNotFound); ok {
      // handle
    } else {
      panic("unknown error")
    }
  }
}

在直接导出自定义错误类型时要小心,因为它们已成为包的公共API的一部分。稳妥的办法是是公开匹配器函数,来鉴别错误类型。

// package foo
//在 foo 包中,自定义错误类型
type errNotFound struct {
  file string
}

//实现Error()方法
func (e errNotFound) Error() string {
  return fmt.Sprintf("file %q not found", e.file)
}

//类型断言
func IsNotFoundError(err error) bool {
  _, ok := err.(errNotFound)
  return ok
}

//返回错误
func Open(file string) error {
  return errNotFound{file: file}
}


// package bar
// 在 bar 包中,调用foo包中导出的方法
if err := foo.Open("foo"); err != nil {
  if foo.IsNotFoundError(err) {
    // handle
  } else {
    panic("unknown error")
  }
}

 

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

相关推荐

Uber Go 语言编程规范 中文版.pdf

Uber Go 语言编程规范 中文版 Uber 是一家美国硅谷的科技公司,也是 Go 语言的早期 adopter. 其开源了很多 golang 项目,诸如被 Gopher 圈熟知的 zap、jaeger 等。2018 年年末 Uber 将内部的 Go 风格规范 开源到 GitHub,经过一年的积累和更新,该规范已经初具规模,并受到广大 Gopher 的关注。本文是该规范的中文版本。

龙芯处理器下面的golang第三方库或框架实地编译与运行测试

编译运行机器环境: CPU 龙芯3A3000 操作系统 中标麒麟v7.0 gcc版本 4.9 先说不能用的吧: godror:用于访问oracle的,编译项目没有问题,但是运行时依赖的oracleInstant Client没有mips架构的.so库文件。 其他常用的编译运行没问题的(直接贴的go build的时候自动下载第三方库的内容,太多了懒得整理名称了)...

程序员记事本 1405

向量化和向量数据库的开发步骤,以及本地docker下载Redis-stack-server,以及如何将文本转成向量,以及文本向量化成功后将数据存入到Redis-stack-server这个向量数据库

内存可以作为向量数据库,但是一重启一断电数据就没了这了选择RedisStack作为向量数据,用来向量的存储,未来会改名成Redis8,也就是在原本的Reids的功能上增加了新的特性,本质上还是Redis向量数据库还可以用ElaticSearch、MongoDB等。

qq_61723836的博客 1086

下载zap包、atomic包、multierr包

下载zap包、atomic包、multierr包 zap包 下载地址:github.com/uber-go/zap 可以使用 go get github.com/uber-go/zap atomic包 下载地址:github.com/uber-goatomic 可以使用 go get github.com/uber-go/atomic multierr包 下载地址:github.com/uber-...

qq_29807203的博客 880

避坑指南:Allegro 17.2更新封装时遇到的5个典型问题及解决方案(含Symbol报错处理)

本文深度解析Allegro 17.2封装更新过程中的核心机制与常见陷阱。针对“Update Symbols”功能失效、焊盘不匹配、DRC报错、图形层叠错误等5大典型问题,提供从原理分析到实战解决方案的完整指南,帮助用户实现从“更新失败”到“丝滑替换”的平稳过渡。

tgb34567890的博客 1040

计组实验之四路表决器

请在之前四路表决器电路实现的基础上,继续用连接线 联接CD4511,将投票为1的票数总和显示到一个 LED上,思考如何做?由于我们需要通过显示字形来直接看出有几个1,在这里,我们最多有四个1,即显示字形最多到4就行,所以我们需要将有几个1用2进制数来表示,下面给出了相关电路图。显示输入插口,按真值表(自拟)要求,逐次改变输入变量, 测量相应的输出值,验证逻辑功能, 与表3-1 进行比较, 验证所设计的逻辑电路是否符合要求。用实验结果与真值表3-1和3-2进行比对,可以得出,我们实验结果是正确的。

szyugly的博客 1万+

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

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

后端开发 1740

【杰理AC696X】ADKEY复用指示灯不定时出现灯不亮或按键失灵的问题

测试SDK版本:《ac696n_soundbox_sdk_v1.5.0-20211217》ADKEY复用指示灯的做法多用于蓝牙小音箱,IC引脚越来越少,复用也就用的越多了,不过,在使用前应评估好功能,因为复用的做法,肯定会牺牲点东西的,如果体验感啥的。 比如这个图,(V-)按键按下时,LED是会一直导通发光的,按不同阻值的按键还有亮度不一致的问题,这样的问题有的客户是不接受的,这就要另寻他法了。某天调好案子,放在一边测试时,发现指示灯不亮了,按键也不起作用,想起之前AC692系列也有类似的问题,很快就定位到

xx842678的博客 1656

Uber Go 语言编程规范

相信很多人都看过 Uber 在 GitHub 上面开源的 Go 语言编程规范了,原文在这里:https://github.com/uber-go/guide/blob/master/st...

Docker的专栏 326

无人机开发平台全解析:从开源飞控到企业级应用实战指南

无人机开发平台是无人机从飞行器演变为智能空中机器人的核心,其本质是提供了一套标准化的软硬件接口与工具链,使开发者能够基于稳定可靠的底层系统,专注于上层应用创新。从技术原理上看,一个完整的开发平台通常包含飞行控制器、机载计算机、传感器套件等硬件层,以及飞控固件、机器人操作系统(ROS/ROS 2)、软件开发套件(SDK)等软件层,通过分层架构实现飞行控制、感知决策与任务执行的解耦。其技术价值在于大幅降低了无人机行业应用的开发门槛,使开发者无需从零构建飞行控制系统,即可快速实现自动巡检、精准农业、物流配送等复杂

weixin_28712491的博客 412

TC3XX - MCAL知识点(三十五):Tasking编译器下,Tc3xx的MCAL代码如何使用多核,多核中断、多核任务、多核外设之间的MCAL配置与代码例程

文章用于记录在裸机情况下使用多核Tc387芯片,如何高效运行以及正确的代码、工程属性、链接文件配置等问题,相互结合、相互影响的地方,以示后续使用记录。

梦想技术家 965

Uber Go 语言编码规范

Uber Go 语言编码规范 中文版

J_Lee 2214

YOLO26涨点改进| TGRS 2026 | 独家创新首发、注意力改进篇| 引入CSSCA频谱-空间交叉注意力,含多种创新改进,小目标检测、图像分割、高光谱图像分类、语义分割任务任务涨点

🔥本文提出CSSCA(频谱-空间交叉注意力)模块,通过中心像素引导的光谱与空间交叉注意力机制,有效提升YOLO26模型的特征表达能力。该模块实现了光谱与空间信息的协同优化,能够自适应强化关键通道与重要空间区域,增强模型对小目标和复杂场景的感知能力。文章详细介绍了CSSCA的网络结构、工作原理及四大优势,包括精准特征表达、协同信息优化、小样本适应性和轻量化设计。同时提供了完整的代码实现和四种改进方案的YAML配置文件,包括基础版、增强版、C3k2融合版和C2PSA融合版,为YOLO26模型的性能提升

Ai缝合怪、助力小伙伴高效发论文 269

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

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

问题不大 2197

解锁RK3588+RTL8211F:千兆以太网PHY调优秘籍

本文探讨了RK3588芯片搭配RTL8211F千兆以太网PHY的优化方案。文章首先分析了RK3588和RTL8211F的硬件特性,指出时序问题可能源于时钟信号不稳定、传输延迟和PHY内部逻辑延迟。针对这些问题,提出了选用高质量时钟源、优化PCB布线等时序优化策略,以及合理配置硬件参数、优化网络协议等延迟优化方法。在配置实践部分,详细介绍了硬件连接规范和软件配置步骤,并建议使用Iperf、Ping等工具进行性能测试。最后总结了常见问题解决方案,展望了未来PHY芯片和传输技术的发展趋势。这些优化措施可显著提升网

远程部署调试 运行安装 项目调试 二次开发 项目技术新 持续迭代 部分源码免费分享 289

精雕软件(JDpaint) 5.5 绿色版

精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版

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

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

代码讲故事 1113

怀旧版电脑GBC模拟器

再现原版GBC掌机的界面,电脑运行连游戏界面都一样大小,很怀旧,很真实,(英文版)强烈推荐,很小的文件,很难才找到的。

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

数学建模模型总结

这是本人在两年内准备参加数学建模竞赛搜集到的模型资料,已经经过了本人的筛选和整理,希望能够对准备参加数学建模竞赛的学弟学妹们提供一些帮助!

IMSL CNL 7.0.0 (x86-64)Crack

IMSL CNL 7.0.0 (x86-64)Crack intel的算法库破解文件,这是C++版本的破解文件

Uber Go 语言编码规范中文版:从入门到精通的终极指南

Uber Go 语言编码规范中文版是每个Go开发者必备的终极指南!🚀 作为硅谷科技巨头Uber内部使用的Go代码规范,这份完整指南涵盖了从基础语法到高级性能优化的所有最佳实践。无论你是Go语言新手还是经验丰富的Gopher,这份规范都能帮助你编写更高质量、更易维护的Go代码。 ## 📚 为什么需要Go编码规范? 在大型项目中,统一的代码风格和最佳实践至关重要。Uber作为Go语言的早期采用

gitblog_00488的博客 921

Uber Go 风格指南中文版

uber_go_guide_cn Uber Go语言编码规范 Uber是世界领先的生活出行服务提供商,也是Go语言的早期adopter,根据Uber工程博客的内容,大致可以判断出Go语言在Uber内部扮演了十分重要的角色。Uber内部的Go语言工程实践也是硕果累累,有大量Go实现的内部工具被Uber开源到github上,诸如被Gopher圈熟知的zap、jaeger等。2018年年末Uber将内部...

谢小军的专栏 3197

Uber Go 风格指南:Error Naming 错误命名规范——全局错误变量与自定义错误类型的命名法则

> 本文基于本仓库(Uber Go Style Guide)中的 [Error Naming(错误命名)](https://link.gitcode.com/i/7ae73935233af292da83e2cd4c3b5a50) 一节展开,讲解 Go 错误处理的命名纪律:全局错误变量以 `Err` / `err` 为前缀,自定义错误类型以 `Error` 为后缀。文章同时结合 [Error Typ

gitblog_00416的博客 827

告别混乱代码:Uber Go风格规范实战指南

在Go语言开发中,代码风格的一致性和规范性直接影响项目的可维护性和团队协作效率。Uber Go风格规范作为业内广泛认可的权威指南,为开发者提供了一套全面的编码标准。本文将带你深入了解这一规范的核心要点,帮助你写出更优雅、高效的Go代码。 ## 为什么选择Uber Go风格规范? Uber作为全球知名的科技公司,其开源的Go风格规范凝聚了众多工程师的实践经验。该规范不仅涵盖了代码格式化、命名约定

gitblog_01091的博客 467

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

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

gitblog_00941的博客 1080

Uber Go 风格指南:Error Types 错误类型声明与匹配策略全解

本篇指南以 [Uber Go Style Guide](https://link.gitcode.com/i/bc4114471fb4ce2a491f46bf8e889b79) 中 Errors 章节的 [Error Types](https://link.gitcode.com/i/e6d1e03d3c09be0fcd8eca70331c8177) 为核心,系统讲解 Go 中声明错误的四种方式:

gitblog_00313的博客 416

Uber Go 指南(中文版)

--- ## 项目介绍 **Uber Go 指南** 是由 Uber 工程团队维护的一个项目,它旨在提供一套详细且实用的 Go 语言编程最佳实践。这份指南不仅适合刚接触 Go 语言的新手,也对有经验的 Go 开发者有借鉴意义。它覆盖了从基础语法到高级特性的广泛范围,特别强调在大型复杂系统中的应用,帮助开发者理解如何遵循 Uber 的工程标准来编写高质量的 Go 代码。 ## 项目快速启动 ...

gitblog_01027的博客 1073
上一篇: Uber Go 语言编程规范:使用time处理时间
下一篇: 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、付费专栏及课程。

余额充值