go基础1-1：常用命令、标识符、关键字、命名规则

golang基础：常用命令、标识符、关键字、命名规则

1 常用命令

更多请参考官方文档

2 golang标识符

2.1 标识符

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

2.2 标识符的组成

1. 标识符由数字、字母和下划线(_)组成。如：123 abc _
2. 只能以字母和下划线(_)开头。如：abc123 _sysVar **错误：**123abc
3. 标识符区分大小写。 name Name NAME

正确的命名

package main
import "fmt"
func main() {
	var name string
	var age int
	var _sys int
}
复制代码

错误的标识符

package main
import "fmt"
func main() {
	var 1name string
	var &age int
	var !email
}
复制代码

3 go语言关键字

go语言提供了25个关键字，如下所示。

除了以上介绍的这些关键字，Go 语言还有 36 个预定义标识符，其中包含了基本类型的名称和一些基本的内置函数，见下表：

4 go语言命名规范

4.1Go区分大小写

命名规则涉及变量、常量、全局函数、结构、接口、方法等的命名。 Go语言从语法层面进行了以下限定：任何需要对外暴露的名字必须以大写字母开头，不需要对外暴露的则应该以小写字母开头。

当命名（包括常量、变量、类型、函数名、结构字段等等）以一个大写字母开头，如：GetUserName，那么使用这种形式的标识符的对象就可以被外部包的代码所使用（客户端程序需要先导入这个包），这被称为导出（例如java语言中的 public）； 命名如果以小写字母开头，则对包外是不可见的，但是他们在整个包的内部是可见并且可用的（例如java语言中的 private ）

4.2 包名称

保持package的名字和目录保持一致，尽量采取有意义的包名，简短，有意义，尽量和标准库不要冲突。包名应该为小写单词，不要使用下划线或者混合大小写。

package dao
package service
复制代码

4.3 文件命名

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

customer_dao.go
复制代码

4.4 结构体命名

采用驼峰命名法，首字母根据访问控制大写或者小写

struct 申明和初始化格式采用多行，例如下面：

type CustomerOrder struct {
    Name string 
    Address string
}
order := CustomerOrder{"wanik", "江苏苏州"}
复制代码

4.5 接口命名

命名规则基本和上面的结构体类型

单个函数的结构名以 “er” 作为后缀，例如 Reader , Writer 。

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

4.6 变量命名

和结构体类似，变量名称一般遵循驼峰法，首字母根据访问控制原则大写或者小写，但遇到特有名词时，需要遵循以下规则：

如果变量为私有，且特有名词为首个单词，则使用小写，如 appService 若变量类型为 bool 类型，则名称应以 Has, Is, Can 或 Allow 开头

var isExist bool
var hasConflict bool
var canManage bool
var allowGitHook bool
复制代码

4.7 常量命名

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

const APP_URL = "https://www.wanik666.com"
复制代码

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

type Scheme string

const (
    HTTP  Scheme = "http"
    HTTPS Scheme = "https"
)
复制代码

5 错误处理

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

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

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

6 单元测试

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

以上就是编写go之前要了解的一些基本知识和注意事项