在 Go 语言中,包(Package) 是管理代码模块化、复用性与可维护性的核心单位。本章将讲解如何组织包结构、如何导入其他包、以及项目中的最佳实践。
一、什么是包?
- • 每个
.go
文件都属于某个包(通过package
声明) - • 每个包对应一个目录(一个目录只能有一个包名)
- • Go 程序从
main
包中的main()
函数开始执行
// 文件名:main.go package main import "fmt" func main() { fmt.Println("Hello, World!") }
二、包的命名与组织结构
1. 包名建议:
- • 与目录同名
- • 简洁有意义,通常使用小写字母
- • 避免与标准库重名
2. 示例结构:
myapp/ ├── main.go // main 包 ├── config/ // 配置相关包 │ └── config.go // package config ├── utils/ // 工具函数 │ └── string_util.go // package utils ├── service/ // 核心业务逻辑 │ └── user.go // package service
三、包的导入与使用
1. 基本导入:
import "myapp/utils"
调用包内函数:
utils.DoSomething()
⚠️ 注意:要访问包中的函数或变量,必须首字母大写(即导出)。
2. 多个包导入:
import ( "fmt" "myapp/config" "myapp/utils" )
四、包的路径与 go.mod
- • Go 模块系统使用
go.mod
记录模块路径 - • 自定义包的导入路径必须以模块名开头
例如:
module github.com/yourname/myapp
那么 utils
包的导入路径为:
import "github.com/yourname/myapp/utils"
五、导入技巧
1. 给包取别名:
import u "github.com/yourname/myapp/utils" u.DoSomething()
2. 匿名导入(仅执行 init()
函数):
import _ "net/http/pprof"
3. 点导入(不推荐):
import . "fmt" Println("Hello") // 不用 fmt.Println,但不易读
六、小结
关键点 | 说明 |
包名 = 目录名 | 每个目录即是一个包,包名通常与目录一致 |
大写导出 | 包中变量、函数首字母大写表示对外可访问 |
使用 go.mod 路径 |
所有导入路径必须以模块名为前缀 |
多包组织结构清晰 | 配置、业务、工具等应分包存放,便于维护 |
可设置导入别名 | 避免包名冲突,提高代码可读性 |