内容简介:a.统一工作区间,避免目录及文件名随意b.规范变量/结构体/方法及接口名c.规范注释
一.说明
- 编程规范好,可避免语言陷阱,可有利团队协作,有利项目维护。
- 正常的 Go 编程规范有两种:编译器强制的(必须的),gofmt格式化非强制的(非必须)。
- Go宣告支持驼峰命名法,排斥下划线法。
- 自定义原则:
a.统一工作区间,避免目录及文件名随意
b.规范变量/结构体/方法及接口名
c.规范注释
d.单元测试/程序效率等建议
两个等级: (S)建议,(M)必须。以下是细节。
二.代码组织结构
- (M)一个目录只包含一个包,模块复杂拆分子模块/子目录
- (S)内部项目GOPATH如果指向多个工作目录。公开项目为第一个工作区间(即go get默认下载到第一个目录)
- (M)非测试文件(*_test.go)禁止使用,简化包
- (M)禁止相对路径导入包
- (S)建议goimports或者IDE管理import
- (S)项目rep需要包含所有的代码,依赖库放在vendor下
- (S)建议使用Golide,Godep管理第三方包
总而言之:组织结构需要简化,一目了然,允许多个工作区间,但是环境变量的第一个工作区间必须是公开的项目,最好使用一个工作区间,不要建立相对路径的包,最好用godep等依赖库控制 工具 来管理依赖库,每个项目所有的依赖库最好放在本目录vendor下。
三.代码风格
- (M)提交代码时gofmt格式化代码,golint检查代码(使用IDE时默认这两个工具会自动用到)
- (S)json字符串建议使用反单引号(`)
- (M)文件名必须小写,允许下划线'_’,但头尾不能。避免与_test.go或者系统相关_386.go等冲突
- (S)文件名以功能为指引,不需要再出现模块名
- (M)目录名必须小写,允许中划线'-',但头尾不能
- (S)不建议目录名出现下划线'_'
- (M)包名必须全部小写,无下划线,越短越好,尽量不要与标准库重名,禁止通过中划线连接多个单词
- (S)包名尽量与目录名一致
- (M) 函数名和结构体名必须为大小写驼峰模式,最好不带特殊字符如划线等
- (S)函数名建议动词或者动宾结构单词,结构体建议名词或者动名词
- (S)常量和枚举名,大小写驼峰法,不允许下划线,第三方包例外。
- (M)函数参数首字母小写,不能有下划线,按大小驼峰法
- (S)函数参数按紧密程度安排位置,同类型参数应该相邻
- (S)参数不大于5个
- (M)变量名不允许下划线,大小写驼峰法,局部变量首字母小写,全局变量首字母大写
- (S)避免全局变量多使用,for循环可用单字母
- (M)接口名大小写驼峰法,首字母大写,不能下划线,名词
- (S)接口名'er'结尾
- (M)复杂功能请多写注释备注,注释表达需清晰,不要啰嗦。注释标准暂时不强制,最好参考godoc,如包注释使用/**/,首字母大写,注释后空一行,函数注释写在函数上方等。
总而言之,文件名和目录名,包名都必须小写。数据类型变量和参数等定义最好使用驼峰大小写法,不要使用下划线或者中划线
四. 单元测试/程序效率
- (S)建议少使用main方法测试,而是使用_test.go做测试
- (M)与其他语言类似,避免多级if或者for嵌用,代码层次需简单,绕脑层次少
- (M)避免傻逼命名,如IsTrue变量,if(!IsTrue).
- (M)请熟悉Go语言各特征,避免低效用法。请至少阅览一遍:
# 拉镜像 docker pull hunterhug/gotourzh # 前台运行 docker run -it -p 9999:9999 hunterhug/gotourzh # 后台运行(类似nohup) docker run -d -p 9999:9999 hunterhug/gotourzh
打开http://127.0.0.1:9999 学习即可!
以上所述就是小编给大家介绍的《Golang语言编程规范》,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对 码农网 的支持!
猜你喜欢:- 那些主流编程语言的知识:C 语言(一)
- 那些主流编程语言的知识:C 语言(一)
- 区块链技术语言(二十七):Go语言并发编程(上)
- 区块链技术基础语言(三十一):Go语言网络编程(上)
- 区块链技术基础语言(三十二):Go语言网络编程(下)
- 逻辑式编程语言极简实现(使用C#) - 1. 逻辑式编程语言介绍
本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。
敏捷软件开发
Robert C.Martin,、Micah Martin / 邓辉、孙鸣 / 人民邮电出版社 / 2010-12 / 79.00元
要想成为一名优秀的软件开发人员,需要熟练应用编程语言和开发工具,更重要的是能够领悟优美代码背后的原则和前人总结的经验——这正是本书的主题。本书凝聚了世界级软件开发大师Robert C. Martin数十年软件开发和培训经验,Java版曾荣获计算机图书最高荣誉——Jolt大奖,是广受推崇的经典著作,自出版以来一直畅销不衰。 不要被书名误导了,本书不是那种以开发过程为主题的敏捷软件开发类图书。在......一起来看看 《敏捷软件开发》 这本书的介绍吧!
CSS 压缩/解压工具
在线压缩/解压 CSS 代码
HEX CMYK 转换工具
HEX CMYK 互转工具