Go代码基本标准规范

文档 #

  • 不刻意制定详细文档
  • 编码级别文档化,支持一键导出文档

统一的标准和习惯,提高可读性 #

三个统一

  • 统一的日志
  • 统一的接口规范:错误码、返回格式、国际化
  • 统一编码习惯

统一编码习惯 #

变量常量

  • 变量必须见名知义不得用拼音,且长度在 3-20 个字母
  • 名词必须单数
  • 常量必须全大写

所有程序必须有注释

提交记录必须指明 tapd 单号,功能,更新记录

代码文件名

  • 必须见名知义,保证内部代码单一职责
  • 文件夹必须与包名保持一致全小写,尽量使用短命名,不能使用下划线、中划线等字符

函数

  • 单个函数长度不超过 50
  • 参数个数不要超过 5 个(参数过多通常意味着缺少封装,不易维护,容易出错)
  • 函数返回值个数不要超过 3 个,如果超过,建议将其中关系密切的返回值参数封装成一个结构体。

格式化要求 提交代码时,必须使用 gofmt 对代码进行格式化 提交代码时,必须使用 golint 对代码进行检查。 字符串形式的 json 时,使用反单引号,而不是双引号。

"{\"key\":\"value\"}"

改为格式更清晰的:

`
{
    "key":"value"
}
`

接入自动格式化检查 #

接入自动化代码缺陷扫描 #



本图书由小熊©2021 版权所有,所有文章采用知识署名-非商业性使用-禁止演绎 4.0 国际进行许可。