【Go】5、golang标识符、关键字、命名规则

1、标识符

• 标识符的英文是identifier，通俗的讲，就是给变量、常量、函数、方法、结构体、数组、切片、接口起名字

2、标识符的组成

• 标识符由数字、字母和下划线(_)组成
• 只能以自字母和下划线(_)开头
• 标识符区分大小写

3、举例说明标识符的命名

• 正确的命名

package main

func main() {
	var name string
	var age int
	var _sys int
}

• 错误的标识符

func main() {
	var iname string
    var &age int
    var !email
}

4、关键字

• 关键字是指编程语言中预先定义好的具有特殊含义的标识符。关键字和保留字都不建议用作变量名
• go语言中有25个关键字

    break        default      func         interface    select
    case         defer        go           map          struct
    chan         else         goto         package      switch
    const        fallthrough  if           range        type
    continue     for          import       return       var

• go语言中还保留37个保留字

Constants:    true  false  iota  nil

Types:    int  int8  int16  int32  int64  uint  uint8  uint16  uint32  uint64  uintptr float32  float64  complex128  complex64  bool  byte  rune  string  error

Functions:   make  len  cap  new  append  copy  close  delete complex  real  imag panic  recover

5、Go语言命名规范

• Go是一门区分大小写的语言
• 命名规范涉及变量、常量、全局函数、结构、接口、方法等的命名。Go语言从语法层面进行了以下限定：任何需要对外暴露的名字必须以大写字母开头，不需要对外暴露的则应该以小写字母开头
• 当命名(包括常量、变量、类型、函数名、结构字段等等)以一个大写字母开头，如:GetUserName，那么使用这种形式的标识符的对象就可以被外部包的代码所使用(客户端程序需要先导入这个包)，这种被导出(像面向对象语言中的public)；命名如果以小写字母开头，则对包外是不可见的，但是他们在整个包的内部是可见并且可用的(像面向对象语言中的private)
• 包名称
• 保持package的名字和目录保持一致，尽量采取有意义的包名，简短，有意义，尽量和标准库不要冲突。包名应该为小写单词，不要使用下划线或者混合大小写

package dao
package service

• 文件命名
• 尽量采取有意义的文件名，简短、有意义，应该为小写单词，使用下划线分隔各个单词。

customer_dao.go

• 结构体命名
• 采用驼峰命名法，首字母根据访问控制大写或小写
• struct申明和初始化格式采用多行，例如下面：

type CustomerOrder struct {
	Name string
    Address string
}
order := CutomerOrder{'tom', '北京海淀'}

• 接口命名
• 命名规则基本和上面的结构体相同
• 单个函数的结构以"er"作为后缀，例如Reader，Writer

type Reader interface {
	Read(p []byte)(n int, err error)
}

• 变量命名
• 和结构体类似，变量名称一般遵循驼峰法，首字母根据访问控制原则大写或小写，但遇到特有名词时，需要遵循以下规则：
• 如果变量为私有，且特有名词为首个单词，则使用小写，如appService若变量类型为bool类型，则名称应以Has、Is、Can或者Allow开头

var isExist bool
var hasConfict bool
var canManage bool
var allowGitHook bool

• 常量命名
• 常量均需使用全部大写字母组成，并使用下划线分词

const APP_URL = 'https://xxxx.xxxx.com'

• 如果是枚举类型的常量，需要先创建相应类型

type Scheme string
const (
	HTTP Scheme = 'http'
    HTTPS Scheme = 'https'
)

• 错误处理
• 错误处理的原则就是不能丢弃任何有返回err的调用，不要使用_丢弃，必须全部处理。接收到错误，要么返回err，或者使用log记录下来尽早return：一旦有错误发生，马上返回，尽量不要使用panic，除非你知道你在做什么，错误描述如果是英文必须为小写，不需要标点结尾，采用独立的错误流进行处理

// 错误写法
if err != nil {
	// 错误处理
}else {
	// 正常代码
}

// 正确写法
if err != nil {
	// 错误处理
    return // 或者继续
}
// 正常代码

• 单元测试
• 单元测试文件名命名规范为example_test.go，测试用例的函数名称必须以Test开头，例如：TestExample每个重要的函数都要首先编写测试用例，测试用例和正规代码一起提交方进行回归测试