高质量编程与性能调优实战 | 青训营笔记
这是我参与 「第三节青训营-后端场」笔记创作活动的第三篇
高质量编程与性能调优实战
高质量编程
简介
什么是高质量?
- 正确性:是否考虑各种边界条件,错误的调用是否能够处理
- 可靠性:异常情况或者错误的处理策略是否明确,依赖的服务出现异常是否能够处理
- 简洁:逻辑是否简单,后续调整功能或新增功能是否能够快速支持
- 清晰:其他人在阅读理解代码的时候是否能清楚明白,重构或者修改功能是否不会担心出现无法预料的问题
推荐使用 gofmt 自动格式化工具
goimports也是go语言官方提供的工具,实际等于 gofmt 加上依赖包的管理
编码规范
- 注释
- 注释代码作用、代码如何做的、代码实现的原因、代码什么情况下会出错
- 命名规范
- 变量名
- 简洁胜于冗长
- 缩略词全大写,当其位于变量开头且不需要导出时,使用全小写
- 变量距离其被使用的地方越远,则需要携带越多的上下文信息
- 函数名
- 函数名不携带包名的上下文信息
- 函数名尽量简短
- 包名
- 只由小写字母组成,不包含大写字母和下划线等符号
- 简短并包含一定的上下文先洗
- 不要和标准库同名
- 不使用常用变量名作为包名,使用单数,谨慎使用缩写
- 变量名
- 控制流程
- 避免嵌套,保持正常流程清晰
- 尽量保持正常代码路径为最小缩进
- 优先处理错误情况,特殊情况,尽早返回或继续循环来减少嵌套
- 错误和异常处理
- 简单错误
- 简单的错误指的是仅出现一次的错误,且在其他地方不需要捕获该错误
- 优先使用error.New 来创建匿名变量来直接表示简单错误
- 如果格式化的需要,使用fmt.Errorf
- 错误的 Wrap和Unwrap
- 错误判定
- 是否为特定错误,使用errors.ls
- 不同于使用 == 使用该方法可以判定错误链上的所有错误是否会有特定的错误
- 在错误链上获取特定种类的错误,使用errors.As
- panic用于真正异常的情况
- recover生效范围,在当前goroutine的被defer的函数中生效
- 简单错误
性能优化建议
简介
- 性能优化的前提是满足正确可靠,简洁清晰等质量因素
- 性能优化是综合评估,有时候和时间效率、空间效率可能对立
Benchmark
- 性能表现需要实际数量衡量
- 基准性能测试公工具 benchmark
- 执行命令 go test -bench=. -benchmem
- 结果说明
- 第一项为测试函数名
- 第二项为一共执行的次数
- 第三项为每次执行的时间
- 第四项为每次执行申请多大的内存
- 第五项为每次执行申请几次的内存
Slice预分配内存
- 尽可能在使用mark()初始化切片时提供容量信息
- 切片本质是一个数组片段的描述、包括数组指针、片段的长度、片段的容量(不改变内存分配情况下的最大长度)
- 大内存未释放,使用copy代替re -slice
map预分配内存
- 不断向map中添加元素的操作会触发map扩容
- 提前分配好空间可以减少内存拷贝和Rehash的消耗
- 建议根据实际需求提前预估好需要的空间
使用strings.Builder
使用 + 拼接字符串性能较差
使用空结构体节省内存
空结构体不占据任何的内存空间,节省资源
atomic包
- 锁的实现是通过操作系统来实现的,属于系统调用
- atomic操作是通过硬件实现,效率比锁高
- 用来保护一段逻辑而不是一个变量
- 对于非数值操作,可以使用atomic.Value
性能调优实战
原则
- 要依靠数据不是猜测
- 要定位最大瓶颈而不是细枝末节
- 不要过早优化
- 不要过度优化
工具pprof
简介
- 工具Tool
- 采样Sample
- 分析Profile
- 展示View
排查实战
- 浏览器查看指标
- 运行成功后浏览localhos:t6060/debug/pprof
- 分析 topN命令
- flat 当前函数本身的执行耗时
- flat% flat占cpu总时间的比例
- sum% 上面每一行的flat%总和
- cum 指当前函数本身加上其调用函数的总耗时
- cum% cum占cpu总时间的比例
- flat == cum 函数中没有调用其他函数
- flat == 0 函数中只有其他函数的调用
- 命令 list
- 根据指定的正则表达式查找代码行
- 命令web
- 调用关系可视化
- Heap - 堆内存
- 命令 go tool pprof -http=:8080
- https://localhost:6060/debug/pprof/heap
- goroutine协程
- 命令go tool pprof -hppt=:8080
- http://localhost:6060/debug/pprof/foroutine
- mutex锁
- 命令go tool pprof -hppt=:8080
- http://localhost:6060/debug/pprof/mutex
- block阻塞
- 命令go tool pprof -hppt=:8080
- http://localhost:6060/debug/pprof/block