包
包意义
在 golang 语言中,包(package)是组织代码的基本单元。每个 Go 源文件(以 .go 扩展名结尾)都定义在一个包中,并且每个包都有一个唯一的包名。包可以包含函数、变量、常量、类型定义和接口等。
包声明
在源文件的开头,需要使用 package 关键字声明包名,如package main
;除main外,包名通常是文件夹的路径名,以 / 作为分隔符。例如,如果你的包位于 src/github.com/user/repo/subdir
,那么包名就是 github.com/user/repo/subdir
// 文件:src/myproject/mathutil/add.go
package mathutil // 定义了一个名为 "mathutil" 的包
包导入规范
在golang的语法中,包导入存在一定的规范
- 完全导入:直接写出包名。例如:
import "fmt"
- 别名导入:为包名指定一个简短的别名,以减少代码中的包名书写长度。例如:
import f "fmt"
- 导入空白标识符:为了导入包只为执行其 init 函数(无须直接使用包中的其他导出成员),可以使用 _(空白标识符)作为包名。例如:
import _ "github.com/example/package"
- 避免导入未使用的包:golang 编译器会报错提示未使用的包。如果导入包只是为了其副作用(如 init 函数),可以使用空白标识符导入
- 导入顺序:虽然 golang 语言规范并未规定导入顺序,但通常按照标准库包、第三方库包、自定义包的顺序排列,并在每组内部按照字母顺序排序,以保持代码整洁。
- 循环依赖:golang 不允许包间的循环依赖。在设计包结构时应避免这种情况,确保依赖关系是单向的。
包导出规范
- 标识符首字母大小写决定导出状态:在 golang 语言中,包内定义的任何类型(如结构体、接口)、函数、变量或常量,如果其名称以
大写字母开头
(Unicode 大写字母),则被视为导出(exported),可供其他包访问。例如:package mypackage // 导出的类型和函数 type ExportedType struct{} func ExportedFunction() {} // 未导出的类型和函数 type unexportedType struct{} func unexportedFunction() {}
- 导出成员对外可见:导出的成员可以在其他包中通过包名加成员名的方式访问。例如,如果其他包导入了上面的 mypackage,可以这样使用:
import "path/to/mypackage" func main() { mypackage.ExportedType{} mypackage.ExportedFunction() }
- 包级别的常量和变量:包级别的常量和变量(不在任何函数内定义)也有导出规则。如果它们的名称以大写字母开头,也会被导出。