包的知识点

• 导包可以多行导入

import(
    "fmt"
    "sync"
)

• 可以使用别名，避免同一包名产生冲突

import mrand "math/rand"

• 使用点

但这种用法，会有一定的隐患，就是导入的包里可能有函数，会和我们自己的函数发生冲突

import . "fmt"

func main() {
    Println("hello, world")
}

• 包的初始化init

包被导入时，会执行init函数，优先于main函数，不能有参数和返回值，建议少用，仅用于全局变量初始化，或者单元测试初始化一些东西

• 包的匿名导入

导入一个没有用到的包在编译的时候会报错，如果只想使用init函数来初始化一些任务，可以对包进行匿名导入

import _ "packgename"

• 导入的包是路径

• 使用绝对路径导入，而不是相对路径，避免改变了项目放在src下，改变了GOPATH而导致运行报错

• 包导入的路径的优先级

如果项目下有vendor目录，那么优先级是vender > $GOROOT/src > $GOPATH/src

通常vendor 目录是通过 go mod vendor 命令生成的，这个命令会将项目依赖全部打包到你的项目目录下的 verdor 文件夹中

Go包管理

go的包管理方式，从GOPATH到GO VENDOR到GO MODULES，推荐使用Go Modules

• GOPATH

  可以理解为工作目录，通常的目录结构如下，主要弊端无法在项目中使用指定版本的包，因为其没有包的概念，一个包只能保留一个版本

|_bin：存放编译后生成的二进制可执行文件
|_pkg：存放编译后生成的 .a 文件
|_src：存放项目的源代码，可以是你自己写的代码，也可以是你 go get 下载的包

• go vender

  为了解决 GOPATH 方案下不同项目下无法使用多个版本库的问题，Go v1.5 开始支持 vendor

  它在每个项目的下都创建一个vendor目录，每个项目需要的以来都下载到该目录下，项目之间不相互影响，但是项目同一个包极大可能被多个项目用到了，每个项目下都保留无疑是对磁盘空间的浪费，别人要使用你的项目，你还得想你依赖的包都上传，否则别人很可能无法使用】

• go modules

  参考 (opens new window)

  go v1.11版本开始，go env多了个环境变量GO111MODULE，通过它可以开启或关闭 go mod 模式，它有三个可选值：off、on、auto，默认值是auto

  • GO111MODULE=off禁用模块支持，编译时会从GOPATH和vendor文件夹中查找包
  • GO111MODULE=on启用模块支持，编译时会忽略GOPATH和vendor文件夹，只根据 go.mod下载依赖
  • GO111MODULE=auto，当项目在$GOPATH/src外且项目根目录有go.mod文件时，自动开启模块支持

// 开启go mod方式
go env -w GO111MODULE="on"

// 设置代理
go env -w GOPROXY=https://goproxy.cn,direct

go mod

go modules 模式核心文件

go.mod

• 第一行：模块的引用路径
• 第二行：项目使用的 go 版本
• 第三行：项目所需的直接依赖包及其版本

简单的 go.mod

如何将依赖写入go.mod，通过go get下载安装指定的依赖，或者go build导入import中的依赖也能自动下载

module go-study

go 1.16

require github.com/qq827435393/gohello v0.0.0-20201127010752-c29ed43981d7

复杂的go.mod

• exclude： 忽略指定版本的依赖包
• replace：由于在国内访问golang.org/x的各个包都需要翻墙，你可以在go.mod中使用replace替换成github上对应的库。

module github.com/BingmingWong/module-test

go 1.14

require (
    example.com/apple v0.1.2
    example.com/banana v1.2.3
    example.com/banana/v2 v2.3.4
    example.com/pear // indirect
    example.com/strawberry // incompatible
)

exclude example.com/banana v1.2.4
replace（
    golang.org/x/crypto v0.0.0-20180820150726-614d502a4dac => github.com/golang/crypto v0.0.0-20180820150726-614d502a4dac
    golang.org/x/net v0.0.0-20180821023952-922f4815f713 => github.com/golang/net v0.0.0-20180826012351-8a410e7b638d
    golang.org/x/text v0.3.0 => github.com/golang/text v0.3.0
)

go.sum

每一行都是由 模块路径，模块版本，哈希检验值 组成，其中哈希检验值是用来保证当前缓存的模块不会被篡改。hash 是以h1:开头的字符串，表示生成checksum的算法是第一版的hash算法（sha256）

注意：go.mod 和 go.sum 是 go modules 版本管理的指导性文件，因此 go.mod 和 go.sum 文件都应该提交到你的 Git 仓库中去，避免其他人使用你写项目时，重新生成的go.mod 和 go.sum 与你开发的基准版本的不一致

go mod 相关指令

命令	作用
go mod init	生成 go.mod 文件
go mod download	下载 go.mod 文件中指明的所有依赖到本地cache，默认为$GOPATH/pkg/mod目录）
go mod tidy	整理现有的依赖（添加缺少的包，且删除无用的包）
go mod graph	查看现有的依赖结构
go mod edit	编辑 go.mod 文件，-fmt 格式化文件
go mod vendor	导出项目所有的依赖到vendor目录
go mod verify	校验一个模块是否被篡改过
go mod why	查看为什么需要依赖某模块

go 编码规范

参考 (opens new window)

• 文件命名

  建议统一小写，不同单词之间用“_”隔开，测试文件以_test.go结尾

• 常量命名

  建议大写下划线分割，可以于变量区分开

• 变量命名

  建议驼峰

• 函数命名

  建议驼峰，注意：go根据函数手写字母大小写区分外包能不能访问，需要则大写，不需要小写

• 接口命名

• 注释

• 包导入

Go 常用指令

命令	说明	备注
go version	查看版本
go env	查看环境变量	设置环境变量 go env -w GOPATH=/usr/loca
go build	编译，	go语言程序需要先编译成二进制，再执行，生成可执行文件在当前目录
go run	直接运行	也会先编译，但不会生产二进制文件，而是编译成临时文件直接运行
go install	安装代码包	和go build有些相同，不过会生成很多文件，可执行统一放置到$GOPATH/bin目录下
go clean	清楚文件	可以用于清楚go install生成的多余文件
go get	下载代码包	-u：用于下载指定的路径包及其依赖包，默认情况下，不会下载本地已经存在的，只会下载本地不存在的代码包。就是口中常说的更新包 比如：go get -u github.com/jinzhu/gorm。会把最新的 gorm 包下载到你本地 -d：让命令程序只执行下载动作，而不执行安装动作。 -t让命令程序同时下载并安装指定的代码包中的测试源码文件中依赖的代码包 -fix命令程序在下载代码包后先执行修正动作，而后再进行编译和安装。比如，我的代码是用1.7 开发的，现在go 版本已经是1.13 了，有些包已经发生了变化，那么我们在使用go get命令的时候可以加入-fix标记。这个标记的作用是在检出代码包之后，先对该代码包中不符合Go语言1.7版本的语言规范的语法进行修正，然后再下载它的依赖包，最后再对它们进行编译和安装。 -v打印出那些下载的代码包的名字 -f仅在使用-u标记时才有效。该标记会让命令程序忽略掉对已下载代码包的导入路径的检查。如果下载并安装的代码包所属的项目是你从别人那里Fork过来的，那么这样做就尤为重要了 -x打印出整个过程使用了哪些命令 -insecure 允许命令程序使用非安全的scheme（如HTTP）去下载指定的代码包。如果你用的代码仓库（如公司内部的Gitlab）没有HTTPS支持，可以添加此标记。请在确定安全的情况下使用它。（记得 使用工具 git 时，有个版本就是 http 升级为了https）

Go多环境打包

go可以打包不同环境的可执行文件

Windows下打包，切换到go项目main.go目录下，执行指令：

• Window：默认 go build，生成.exe可执行文件，打包了其他环境需要修改回来，SET GOOS=windows
• Linux：执行 SET CGO_ENABLED=0 SET GOOS=linux SET GOARCH=amd64 go build
• MacOs：执行 ET CGO_ENABLED=0 SET GOOS=darwin3 SET GOARCH=amd64 go build