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

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

1 常用命令

命令	描述
build	编译包和依赖
clean	移除对象文件
doc	显示包或者符号的文档
env	打印go的环境信息
bug	启动错误报告
fix	运行go tool fix
fmt	运行gofmt进行格式化
generate	从processing source生成go文件
get	下载并安装包和依赖
install	编译并安装包和依赖
list	列出包
run	编译并运行go程序
test	运行测试
tool	运行go提供的工具
version	显示go的版本
vet	运行go tool vet

更多请参考官方文档

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个关键字，如下所示。

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 语言还有 36 个预定义标识符，其中包含了基本类型的名称和一些基本的内置函数，见下表：

append	bool	byte	cap	close	complex	complex64	complex128	uint16
copy	false	float32	float64	imag	int	int8	int16	uint32
int32	int64	iota	len	make	new	nil	panic	uint64
print	println	real	recover	string	true	uint	uint8	uintptr

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之前要了解的一些基本知识和注意事项