每個語言都有自己特色的編碼規範，學習該語言的命名規範，能讓你寫出來的程式碼更加易讀，更加不容易出現一些低階錯誤。
本文根據個人編碼習慣以及網路上的一些文章，整理了一些大家能用上的編碼規範，可能是一些主流方案，但不代表官方，這一點先聲明一下。
#由於Windows平台檔案名稱不區分大小寫，所以檔案名稱要一律使用小寫
不同單字之間用下劃線分詞，不要使用駝峰式命名
如果是測試文件，可以以_test. go 結尾
檔案若具有平台特性，應以檔名_平台.go 命名，例如utils_ windows.go，utils_linux.go，可用的平台有：windows, unix, posix, plan9, darwin, bsd, linux, freebsd, nacl, netbsd, openbsd, solaris, dragonfly, bsd, notbsd， android，stubs
一般應用的主入口應為 main.go，或以應用的全小寫形式命名。例如MyBlog 的入口可以為myblog.go
第一種是駝峰命名法，例如appVersion
第二種使用全大寫且用底線分詞，例如APP_VERSION
const ( APP_VERSION = "0.1.0" CONF_PATH = "/etc/xx.conf" )
駝峰命名法
若该变量为 bool 类型，则名称应以 Has, Is, Can 或 Allow 开头。例如：isExist ，hasConflict 。
其他一般情况下首单词全小写，其后各单词首字母大写。例如：numShips 和 startDate 。
若变量中有特有名词（以下列出），且变量为私有，则首单词还是使用全小写，如 apiClient。
若变量中有特有名词（以下列出），但变量不是私有，那首单词就要变成全大写。例如：APIClient，URLString
这里列举了一些常见的特有名词：
// A GonicMapper that contains a list of common initialisms taken from golang/lint
var LintGonicMapper = GonicMapper{
"API": true,
"ASCII": true,
"CPU": true,
"CSS": true,
"DNS": true,
"EOF": true,
"GUID": true,
"HTML": true,
"HTTP": true,
"HTTPS": true,
"ID": true,
"IP": true,
"JSON": true,
"LHS": true,
"QPS": true,
"RAM": true,
"RHS": true,
"RPC": true,
"SLA": true,
"SMTP": true,
"SSH": true,
"TLS": true,
"TTL": true,
"UI": true,
"UID": true,
"UUID": true,
"URI": true,
"URL": true,
"UTF8": true,
"VM": true,
"XML": true,
"XSRF": true,
"XSS": true,
}函数名还是使用 驼峰命名法
但是有一点需要注意，在 Golang 中是用大小写来控制函数的可见性，因此当你需要在包外访问，请使用 大写字母开头
当你不需要在包外访问，请使用小写字母开头
另外，函数内部的参数的排列顺序也有几点原则
参数的重要程度越高，应排在越前面
简单的类型应优先复杂类型
尽可能将同种类型的参数放在相邻位置，则只需写一次类型
使用驼峰命名法，可以用 type alias 来定义大写开头的 type 给包外访问。
type helloWorld interface {
func Hello();
}
type SayHello helloWorld当你的接口只有一个函数时，接口名通常会以 er 为后缀
type Reader interface {
Read(p []byte) (n int, err error)
}注释分为
位于 package 之前，如果一个包有多个文件，只需要在一个文件中编写即可
如果你想在每个文件中的头部加上注释，需要在版权注释和 Package前面加一个空行，否则版权注释会作为Package的注释。
// Copyright 2009 The Go Authors. All rights reserved. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. package net
用于解释代码逻辑，可以有两种写法
单行注释使用 // ，多行注释使用 /* 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 { ...TODO：提醒维护人员此部分代码待完成
FIXME：提醒维护人员此处有BUG待修复
NOTE：维护人员要关注的一些问题说明
单行的包导入
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"
)除了命名规范外，Go 还有很多格式上的规范，比如
使用 tab 进行缩进
一行最长不要超过 80 个字符
因此在格式上的问题，你大部分都可以放心交由 gofmt 帮你调整。关于 gofmt 的文章还在写，应该这两天就会更新。你可以过两天再来看看。
以上是盤一盤 Go 語言中的編碼規範的詳細內容。更多資訊請關注PHP中文網其他相關文章！
