高质量编程简介及编码规范|青训营笔记

65 阅读2分钟

高质量编程简介及编码规范|青训营笔记

在本次课程的学习过程中,我将收获

  • 如何编写出简洁而又清晰的代码
  • go语言程序的常用优化手段
  • 熟悉并掌握go语言的性能分析工具
  • 了解工程中性能优化的原则和流程

在高质量编程方面,需要考虑的问题有很多,比如各种边界条件是否考虑完备、异常情况该如何处理,并保证其稳定性、以及代码的易读易维护。 在编程原则方面主要有以下几个特点:

  • 简单性:消除“多余的复杂性”
  • 可读性:编写可维护代码的第一步是确保代码可读
  • 生产力:团队整体工作效率非常重要 关于如何编写高质量的代码,可以参考以下建议:

推荐使用 gofmt 自动格式化代码。

gofmt 是 Go 语言官方提供的工具,能自动格式化 Go 语言代码为官方统一风格,常见 IDE 都支持方便的配置。此外 goimports 也是 Go 语言官方提供的工具,可以实现自动增删依赖的包引用、将依赖包按字母序排序并分类。

命名规范

  1. 变量: 简洁胜于冗长。 缩略词全大写(比如 ServeHTTP),但当其位于变量开头且不需要导出时,使用全小写(比如 xmlHTTPRequest)。 变量距离其被使用的地方越远,则需要携带越多的上下文信息。
  2. 函数: 函数名不携带包名的上下文信息,因为包名和函数名总是成对出现的。 函数名尽量简短。 当名为 foo 的包某个函数返回类型 Foo 时,可以省略类型信息而不导致歧义。 当名为 foo 的包某个函数返回类型 T 时(T 并不是 Foo),可以在函数名中加入类型信息。
  3. package: 只由小写字母组成,不包含大写字母和下划线等字符。 简短并包含一定的上下文信息,例如 schema、task 等。 不要与标准库同名。

以上建议均引用自网络,遵循编码规范,平时也要多加练习。