盘一盘 Go 语言中的编码规范

每个语言都有自己特色的编码规范，学习该语言的命名规范，能让你写出来的代码更加易读，更加不容易出现一些低级错误。

5.2 代码注释

用于解释代码逻辑，可以有两种写法

单行注释使用 // ，多行注释使用 /* comment */

// 单行注释

/*
多
行
注
释
*/

登录后复制

另外，对于代码注释还有一些更加苛刻的要求，这个看个人了，摘自网络：

所有导出对象都需要注释说明其用途；非导出对象根据情况进行注释。
如果对象可数且无明确指定数量的情况下，一律使用单数形式和一般进行时描述；否则使用复数形式。
包、函数、方法和类型的注释说明都是一个完整的句子。
句子类型的注释首字母均需大写；短语类型的注释首字母需小写。
注释的单行长度不能超过 80 个字符。

类型的定义一般都以单数形式描述：

// Request represents a request to run a command.  type Request struct { ...

登录后复制

如果为接口，则一般以以下形式描述：

// FileInfo is the interface that describes a file and is returned by Stat and Lstat.
type FileInfo interface { ...

登录后复制

函数与方法的注释需以函数或方法的名称作为开头：
```
// Post returns *BeegoHttpRequest with POST method.
```
登录后复制

如果一句话不足以说明全部问题，则可换行继续进行更加细致的描述：

// Copy copies file from source to target path.
// It returns false and error when error occurs in underlying function calls.

登录后复制

若函数或方法为判断类型（返回值主要为 bool 类型），则以 <name> returns true if 开头：

// HasPrefix returns true if name has any string in given slice as prefix.
func HasPrefix(name string, prefixes []string) bool { ...

登录后复制

5.3 特别注释

TODO：提醒维护人员此部分代码待完成
FIXME：提醒维护人员此处有BUG待修复
NOTE：维护人员要关注的一些问题说明

6. 包的导入

单行的包导入

import "fmt"

登录后复制

多个包导入，请使用 () 来组织

import (
  "fmt"
  "os"
)

登录后复制

另外根据包的来源，对排版还有一定的要求

标准库排最前面，第三方包次之、项目内的其它包和当前包的子包排最后，每种分类以一空行分隔。
尽量不要使用相对路径来导入包。

import (
    "fmt"
    "html/template"
    "net/http"
    "os"

    "github.com/codegangsta/cli"
    "gopkg.in/macaron.v1"

    "github.com/gogits/git"
    "github.com/gogits/gfm"

    "github.com/gogits/gogs/routers"
    "github.com/gogits/gogs/routers/repo"
    "github.com/gogits/gogs/routers/user"
)

登录后复制

7. 善用 gofmt

除了命名规范外，Go 还有很多格式上的规范，比如

使用 tab 进行缩进
一行最长不要超过 80 个字符

因此在格式上的问题，你大部分都可以放心交由 gofmt 帮你调整。关于 gofmt 的文章还在写，应该这两天就会更新。你可以过两天再来看看。

以上就是盘一盘 Go 语言中的编码规范的详细内容，更多请关注Work网其它相关文章！