引用包 “github.com/juanfont/headscale/cmd/headscale/cli” 在本地

一、Golang 中包的介绍和定义

fmt、strconv、strings、sort、errors、time、encoding/json、os、io

Golang 中的包可以分为三种：
1、系统内置包。
2、自定义包。
3、第三方包。

fmt、strconv、strings、sort、errors、time、encoding/json、os、io

自定义包：开发者自己写的包。

"github.com/shopspring/decimal"float

二、Golang 包管理工具 go mod

在Golang1.11 版本之前如果我们要自定义包的话必须把项目放在GOPATH 目录。

Go1.11 版本之后无需手动配置环境变量，使用go mod 管理项目，也不需要非得把项目放到GOPATH指定目录下，你可以在你磁盘的任何位置新建一个项目, Go1.13 以后可以彻底不要GOPATH了。

1、go mod init 初始化项目

实际项目开发中我们首先要在我们项目目录中用 go mod 命令生成一个go.mod 文件管理我们项目的依赖。

比如我们的golang 项目文件要放在了itying 这个文件夹，这个时候我们需要在itying 文件夹里面使用go mod 命令生成一个go.mod 文件。

2、go mod 其他命令

• download download modules to local cache (下载依赖的 module 到本地cache))
• edit edit go.mod from tools or scripts (编辑 go.mod 文件)
• graph print module requirement graph (打印模块依赖图))
• init initialize new module in current directory (再当前文件夹下初始化一个新的 module, 创建go.mod 文件))
• tidy add missing and remove unused modules (增加丢失的module，去掉未用的 module)
• vendor make vendored copy of dependencies (将依赖复制到vendor 下)
• verify verify dependencies have expected content (校验依赖检查下载的第三方库有没有本地修改，如果有修改，则会返回非0，否则验证成功。)
• why explain why packages or modules are needed (解释为什么需要依赖)

三、Golang 中自定义包

包（package）是多个Go 源码的集合，一个包可以简单理解为一个存放多个.go 文件的文件夹。

该文件夹下面的所有go 文件都要在代码的第一行添加如下代码，声明该文件归属的包。

package 包名

注意事项：

-

1、定义一个包

如果想在一个包中引用另外一个包里的标识符（如变量、常量、类型、函数等）时，该标识符必须是对外可见的（public）。

在Go 语言中只需要将标识符的首字母大写就可以让标识符对外可见了。

1.1、定义一个包名为 calc 的包

E:\golang\src\pkg\calc\calc.go

创建文件夹：pkg\calc，创建文件：calc.go。

package calc

//首字母大小表示公有，首字母小写表示私有
var a = 100  //私有变量
var Age = 20 //公有变量
func Add(x, y int) int {
	return x + y
}
func Sum(x, y int) int {
	return x - y
}

1.2、main.go 中引入这个包

访问一个包里面的公有属性方法的时候需要通过包名称.去访问。

package main

import (
	"fmt"
	"one/main/src/pkg/calc"
)

func main() {
	c := calc.Add(10, 20)
	fmt.Println(c)
}

running...
30

2、导入一个包

单行导入

单行导入的格式如下：

import "包1"
import "包2"

多行导入

多行导入的格式如下：

import (
	"包1"
	"包2"
)

匿名导入包

如果只希望导入包，而不使用包内部的数据时，可以使用匿名导入包。

具体的格式如下：

import _ "包的路径"

匿名导入的包与其他方式导入的包一样都会被编译到可执行文件中。

自定义包名

在导入包名的时候，我们还可以为导入的包设置别名。

通常用于导入的包名太长或者导入的包名冲突的情况。

具体语法格式如下：

import 别名 "包的路径"

单行引入定义别名：

import c "itying/calc"

多行引入定义别名：

import (
	"fmt"
	c "itying/calc"
)

四、Golang 中 init() 初始化函数

init() 函数介绍

在Go 语言程序执行时导入包语句会自动触发包内部 init()函数的调用。

需要注意的是： init() 函数没有参数也没有返回值。

init()函数在程序运行时自动被调用执行，不能在代码中主动调用它。

包初始化执行的顺序如下图所示：

init()函数执行顺序

Go 语言包会从main 包开始检查其导入的所有包，每个包中又可能导入了其他的包。

Go 编译器由此构建出一个树状的包引用关系，再根据引用顺序决定编译顺序，依次编译这些包的代码。

在运行时，被最后导入的包会最先初始化并调用其init()函数， 如下图示：

五、Golang 中使用第三方包

我们可以在 https://pkg.go.dev/ 查找看常见的 golang 第三方包。

1、找到我们需要下载安装的第三方包的地址

decimal

https://github.com/shopspring/decimal

2、安装这个包

第一种方法：go get 包名称（全局）

go get github.com/shopspring/decimal

PS E:\golang\src> go get github.com/shopspring/decimal
go: downloading github.com/shopspring/decimal v1.3.1
go: added github.com/shopspring/decimal v1.3.1
PS E:\golang\src>

查看包安装路径：

go env

以下即是go的包安装路径
set GOPATH=C:\Users\Administrator\go

第二种方法：go mod download （全局）

package main

import (
	"fmt"

	"github.com/shopspring/decimal"
)

func main() {
	quantity := decimal.NewFromInt(3)
	fmt.Println(quantity)
}

运行命令

go mod download

go run .\main.go 或者 go install

赖包会自动下载到 $GOPATH/pkg/mod，多个项目可以共享缓存的mod，注意使用 go mod download 的时候首先需要在你的项目里面引入第三方包。

第三种方法：go mod vendor 将依赖复制到当前项目的 vendor 下（本项目）

go mod vendor

将依赖复制到当前项目的 vendor 下。

注意：使用 go mod vendor 的时候首先需要在你的项目里面引入第三方包。

3、看文档使用这个包

包安装完毕后我们就可以看文档使用这个包了…

示例下载 gjson 包

PS E:\golang\src> go get -u github.com/tidwall/gjson
go: downloading github.com/tidwall/gjson v1.14.4
go: downloading github.com/tidwall/pretty v1.2.0
go: downloading github.com/tidwall/match v1.1.1
go: downloading github.com/tidwall/pretty v1.2.1
go: added github.com/tidwall/gjson v1.14.4
go: added github.com/tidwall/match v1.1.1
go: added github.com/tidwall/pretty v1.2.1
PS E:\golang\src>

开始使用多模块的工作空间

用一个共享的多模块工作空间创建两个模块。

跨越这些模块进行更改，并且在构建中看到这些结果的改变。

1、创建 workspace 目录

PS E:\> mkdir workspace


    目录: E:\


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----          2023/1/8     17:18                workspace


PS E:\>

2、初始化模块

hellogolang.org/x/example

hello

PS E:\workspace> mkdir hello


    目录: E:\workspace


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----          2023/1/8     18:12                hello


PS E:\workspace> cd .\hello\
PS E:\workspace\hello> go mod init example.com/hello
go: creating new go.mod: module example.com/hello
PS E:\workspace\hello> dir


    目录: E:\workspace\hello


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a----          2023/1/8     18:13             34 go.mod


PS E:\workspace\hello>

通过使用 go get 命令添加依赖于 golang.org/x/example 模块。

PS E:\workspace\hello> go get golang.org/x/example
go: downloading golang.org/x/example v0.0.0-20220412213650-2e68773dfca0
go: added golang.org/x/example v0.0.0-20220412213650-2e68773dfca0
PS E:\workspace\hello>

hellohello.go

package main

import (
  "fmt"
  "golang.org/x/example/stringutil"
)


func main() {
  fmt.Println(stringutil.Reverse("Hello"))
}

现在，运行 hello 程序：

PS E:\workspace\hello> go run .\hello.go
olleH
PS E:\workspace\hello>
PS E:\workspace\hello> go run .\hello.go
敌无下天
PS E:\workspace\hello>

3、创建工作空间

go.work

workspace

PS E:\workspace> go work init ./hello
PS E:\workspace>
PS E:\workspace> ls


    目录: E:\workspace


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----          2023/1/8     18:20                hello
-a----          2023/1/8     18:33             21 go.work


PS E:\workspace>

go work init./hello

go.work

go.workgo.mod

go 指令告诉 Go 应该使用哪个版本的 Go 来解释文件。
它 go.mod 中 go 指令是类似的。

hello

4、在 workspace 目录下运行程序

在 workspace 目录下，运行：

PS E:\workspace> go run example.com/hello
敌无下天
PS E:\workspace>

这个Go命令包含所有在工作空间中的所有模块作为主模块。

这允许我们在模块中引用一个包，甚至在模块之外。

go run

golang.org/x/example

stringutilReverse

5、下载并修改 golang.org/x/example 模块

在这一步，我们将下载一个Git仓库到拷贝，包含了 golang.org/x/example 模块，添加它到工作空间。

hello

5.1、拷贝仓库

workspace

example

5.2、添加模块到工作空间

example

PS E:\workspace> go work use ./example
PS E:\workspace>

go work usego.work

它看起来像这样：

PS E:\workspace> cat .\go.work
go 1.19

use (
        ./example
        ./hello
)
PS E:\workspace>

example.com/hellogolang.org/x/example

stringutilgo get

6、添加新函数

golang.org/x/example/stringutil

workspace/example/stringutiltoupper.go

package stringutil

import "unicode"

// 将参数中的所有字符转成大写
func ToUpper(s string) string {
	r := []rune(s + "_wg")
	for i := range r {
		r[i] = unicode.ToUpper(r[i])
	}
	return string(r)
}

7、修改 hello 程序，使用函数

workspace/hello/hello.go

package main

import (
	"fmt"

	"golang.org/x/example/stringutil"
)

func main() {
	// fmt.Println(stringutil.Reverse("Hello"))
	fmt.Println(stringutil.ToUpper("Hello"))
}

在工作空间中运行代码：

PS E:\workspace> go run example.com/hello
ASDF_WG
PS E:\workspace>

go.workhelloexample.com/hellogo.workgolang.org/x/example

go.workreplace

因为两个模块在同一个工作空间，所以你很容易在一个模块中改变，然后在另一个模块中使用。

更进一步：

golang.org/x/example

hello/go.modgolang.org/x/example

$ cd hello/
$ go get golang.org/x/example@v0.1.0

这样， go 命令可以正确解析工作区之外的模块。

更多关于工作空间

go work use [-r] [dir]-rgo work editgo work sync

引用包 “github.com/juanfont/headscale/cmd/headscale/cli” 在本地