Shikong/golang-study

Fork 0

mirror of https://gitee.com/shikong-sk/golang-study synced 2025-02-22 23:12:15 +08:00

Shikong 1e4676b7b7 笔记

2021-09-11 18:30:18 +08:00

9.0 KiB

Raw Permalink Blame History

本章目录:

0x01 Go语言基础之包
- 1.包的定义
- 2.包的导入
- 3.包的可见性
- 4.自定义包名
- 5.匿名导入包
- 6.包init()初始化函数
- 7.示例演示

0x01 Go语言基础之包

描述: 在工程化的Go语言开发项目中，Go语言的源码复用是建立在包（package）基础之上的, 可以提高开发效率，使用其他开发者已经写好的代码（站在巨人的肩膀上）。

1.包的定义

描述: Go语言的包（package）是多个Go源码的集合，是一种高级的代码复用方案，Go语言为我们提供了很多内置包，如fmt、os、io等。

我们还可以根据自己的需要创建自己的包，一个包可以简单理解为一个存放.go文件的文件夹。

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

package 包名

// graphical.go
package area

注意事项:

一个文件夹下面直接包含的文件只能归属一个package，同样一个package的文件不能在多个文件夹下。
包名可以不和文件夹的名字一样,但可以与.go文件名称一致，包名不能包含 - 符号并且严格按照变量命名的规则进行。
在导入包时应该从包的GOPATH/src后的路径开始写起其以/作为分隔符。
包名为main的包为应用程序的入口包，这种包编译后会得到一个可执行文件，而编译不包含main包的源代码则不会得到可执行文件。

2.包的导入

描述: 要在代码中引用其他包的内容，需要使用import关键字导入使用的包。具体语法如下:

import "包的路径"

示例演示

// 单行导入的格式如下:
import "包1"
import "包2"

// 多行导入的格式如下:
import (
  "包1"
  "包2"
)

// 实际案例
import (
  "fmt"       // golang 内置包
  "math/rand" // golang 内置包
  "github.com/mattn/go-sqlite3" // golang 项目的工程组织规范
)

Tips: 使用go get导入github上的package, 以 go-sqlite3 为例，采用go get将package进行下载go get github.com/mattn/go-sqlite3，此时该包对应的物理路径是 $GOPATH/src/github.com/mattn/go-sqlite3, 此外在你也可以手动进行下载项目到$GOPATH/src

注意事项：

import导入语句通常放在文件开头包声明语句的下面。
导入的包名需要使用双引号包裹起来,并且如果是多个包需要使用()进行包含。
包名是从$GOPATH/src/后开始计算的，使用/进行路径分隔。
Go语言中禁止循环导入包。

3.包的可见性

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

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

举个例子，我们定义一个包名为pkg2的包，代码如下：

package pkg2
import "fmt"
// # 包变量可见性探究

// 1.首字母小写，外部包不可见，只能在当前包内使用
var a = 100
// 2.首字母大写外部包可见，可在其他包中使用
const Mode = 1

// 3.首字母大写，外部包可见，可在其他包中使用
func Add(x, y int) int {
	return x + y
}
// 4.首字母小写，外部包不可见，只能在当前包内使用
func age() {
	var Age = 18 // 函数局部变量，外部包不可见，只能在当前函数内使用
	fmt.Println(Age)
}
// 5.首字母小写，外部包不可见，只能在当前包内使用
type person struct {
	name string
}
// 6.结构体中的字段名和接口中的方法名如果首字母都是大写，外部包可以访问这些字段和方法
type Student struct {
	Name  string //可在包外访问的方法
	class string //仅限包内访问的字段
}
type Payer interface {
	init() //仅限包内访问的方法
	Pay()  //可在包外访问的方法
}

4.自定义包名

描述: 在导入包名的时候我们还可以为导入的包设置别名。通常用于导入的包名太长或者导入的包名冲突的情况。

具体语法格式如下：

import 别名 "包的路径"

示例演示:

// 1.单行导入方式定义别名：
import "fmt"
import calc "github.com/studygo/pkg_test"
func main() {
	fmt.Println(calc.Add(100, 200))
	fmt.Println(calc.Mode)
}

// 2.多行导入方式定义别名：
import (
    "fmt"
    m "github.com/studygo/pkg_test"
 )
func main() {
	fmt.Println(m.Add(100, 200))
	fmt.Println(m.Mode)
}

5.匿名导入包

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

具体的格式如下：import _ "包的路径"

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

补充说明: 我们可以通过如下格式省略包前前缀,使用想过与同一个.go文件函数类似，但是常常不建议这样使用，可以会与当前文件中的某些相同方法的冲突。

具体的格式如下：import . "包的路径", 示例如下

import (
  . "fmt"
)

func main() {
  Println("我是fmt内置包的函数....")
}

6.包init()初始化函数

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

语法格式:

package custompackage
func init() {
  fmt.Println("custompackage init() execute....")
}

init()函数执行顺序

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

但是实际项目中，Go语言包会从main包开始检查其导入的所有包，每个包中又可能导入了其他的包。Go编译器由此构建出一个树状的包引用关系，再根据引用顺序决定编译顺序，依次编译这些包的代码。在运行时，被最后导入的包会最先初始化并调用其init()函数，如下图示：

注意事项:

init() 函数没有参数也没有返回值。
init() 函数在程序运行时自动被调用执行，不能在代码中主动调用它。

7.示例演示

工程项目结构:

// 自定义包的.go文件
➜  pkg pwd & ls
/home/weiyigeek/app/program/project/go/src/weiyigeek.top/custom/pkg/demo1  //(from $GOPATH))
demo1.go

// 调用自定义包的.go文件
➜  pkg ls
weiyigeek.top/studygo/Day04/packagemain.go

不多说上代码：

// # weiyigeek.top/custom/pkg/demo1/demo1.go #
package demo

import "fmt"

// 静态变量
const FLAG = true

// 基础变量
var Flag = 1

// 包初始化函数
func init() {
	fmt.Println("This is a package demo ")
	Flag = 1024 // 注意点
}

// 包函数
func Show() {
	var msg = " 我是函数内部的变量 "
	fmt.Printf("FLAG => %v, Flag => %v\nmsg:%v\n", FLAG, Flag, msg)
}

// 结构体
type Person struct{ Name string }

func (p Person) paly() {
	fmt.Printf("%v 正在打游戏....", p.Name)
}

// 接口
type IPerson interface{ paly() }

func Exec(i IPerson) {
	i.paly()
}

调用自定义包.go文件:

package main
import (
	"fmt" 	// 不建议如. "fmt" 此使用
	demo "weiyigeek.top/custom/pkg/demo1"
)

func main() {
	fmt.Println(demo.Flag)
	fmt.Println(demo.FLAG)
	demo.Show()
	demo.Exec(demo.Person{Name: "Weiyieek"})
}

执行结果:

This is a package demo
1024
true
FLAG => true, Flag => 1024
msg: 我是函数内部的变量
Weiyieek 正在打游戏....

包总结:

我们可以在GOPATH/src路径下按照golang项目工程组织规范进行创建自定义包。
自定义包中需要外部调用访问的（如变量、常量、类型、函数等），必须首字母进行大写。
导入自定义包时我们可以自定义别名,但是需要满足命名规则已经不能与当前目录名称重名。
多个包都定义init()函数时，从调用的最后一包中递归向上执行输出。

错误说明:

Step 1.引入自定义包的时候报 go.mod file not found in current directory or any parent directory 错误.

go: go.mod file not found in current directory or any parent directory; see 'go help modules' (exit status 1)
no required module provides package weiyigeek.top/custom/pkg/demo1; to add it: go get weiyigeek.top/custom/pkg/demo1 (compile)go-staticcheck

问题原因: go的环境设置问题，其次查看GOPATH目录中src为存放第三方go包。解决办法: go env -w GO111MODULE=auto

Step 2.main redeclared in this block (see details)compiler 错误信息:

main redeclared in this block (see details)compilerDuplicateDecl 03datatype.go(151, 6): main redeclared in this block

原因分析: 在学习study go时候会创建许多.go文件,并且在同一个目录下每个.go的文件里面都有package main,也就是main函数,这就是问题所在。解决办法: 同一个目录下面不能有多个package main，调整或者创建多个文件夹分别放入对应的文件下执行即可。

9.0 KiB Raw Permalink Blame History Unescape Escape