189 8069 5689
这篇文章主要介绍“go语言的注释编码规范有哪些”，在日常操作中，相信很多人在go语言的注释编码规范有哪些问题上存在疑惑，小编查阅了各式资料，整理出简单好用的操作方法，希望对大家解答”go语言的注释编码规范有哪些”的疑惑有所帮助！接下来，请跟着小编一起来学习吧！
创新互联建站秉承实现全网价值营销的理念，以专业定制企业官网，网站建设、成都网站建设，小程序设计，网页设计制作，手机网站制作，网络营销推广帮助传统企业实现“互联网+”转型升级专业定制企业官网,公司注重人才、技术和管理，汇聚了一批优秀的互联网技术人才,对客户都以感恩的心态奉献自己的专业和所长。
注释编码规范：1、所有导出对象都需要注释说明其用途；非导出对象根据情况进行注释。2、如果对象可数且无明确指定数量的情况下，一律使用单数形式和一般进行时描述；否则使用复数形式。3、包、函数、方法和类型的注释说明都是一个完整的句子。4、句子类型的注释首字母均需大写；短语类型的注释首字母需小写。5、注释的单行长度不能超过80个字符。
注释可以帮我们很好的完成文档的工作，写得好的注释可以方便我们以后的维护。
/**/ 的块注释和 // 的单行注释两种注释风格， 在我们的项目中为了风格的统一，全部使用单行注释，注释的质量决定了生成的文档的质量。
所有导出对象都需要注释说明其用途；非导出对象根据情况进行注释。
如果对象可数且无明确指定数量的情况下，一律使用单数形式和一般进行时描述；否则使用复数形式。
包、函数、方法和类型的注释说明都是一个完整的句子。
句子类型的注释首字母均需大写；短语类型的注释首字母需小写。
注释的单行长度不能超过80个字符。
1、包级别
包级别的注释就是对包的介绍，只需在同个包的任一源文件中说明即可有效。
每个包都应该有一个包注释，一个位于 package 子句之前行注释
包注释应该包含下面基本信息
// @Title 请填写文件名称（需要改）
// @Description 请填写文件描述（需要改）
// @Author 请填写自己的真是姓名（需要改） ${DATE} ${TIME}
// @Update 请填写自己的真是姓名（需要改） ${DATE} ${TIME}
package ${GO_PACKAGE_NAME}
2、结构（接口）注释
每个自定义的结构体或者接口都应该有注释说明，该注释对结构进行简要介绍，放在结构体定义的前一行，格式为： 结构体名， 结构体说明。同时结构体内的每个成员变量都要有说明，该说明放在成员变量的后面（注意对齐），实例如下：
// User 用户对象，定义了用户的基础信息
type User struct{
Username string // 用户名
Email string // 邮箱
}
3、函数（方法）注释
每个函数，或者方法（结构体或者接口下的函数称为方法）都应该有注释说明
函数的注释应该包括三个方面
// @title 函数名称
// @description 函数的详细描述
// @auth 作者 时间（2019/6/18 10:57 ）
// @param 输入参数名 参数类型 "解释"
// @return 返回参数名 参数类型 "解释"
4、代码逻辑注释
每个代码块都要添加单行注释
注视使用 TODO 开始 详细如下
// TODO 代码块的执行解释
if userAge < 18 {
}
其它说明
当某个部分等待完成时，可用 TODO: 开头的注释来提醒维护人员。
当某个部分存在已知问题进行需要修复或改进时，可用 FIXME: 开头的注释来提醒维护人员。
当需要特别说明某个问题时，可用 NOTE: 开头的注释：
// NOTE: os.Chmod and os.Chtimes don't recognize symbolic link,
// which will lead "no such file or directory" error.
return os.Symlink(target, dest)
到此，关于“go语言的注释编码规范有哪些”的学习就结束了，希望能够解决大家的疑惑。理论与实践的搭配能更好的帮助大家学习，快去试试吧！若想继续学习更多相关知识，请继续关注创新互联网站，小编会继续努力为大家带来更多实用的文章！