Go语言通过包实现代码模块化,包名与目录同名,main包为程序入口;首字母大写的标识符可导出,小写的仅包内可见。创建自定义包需定义包名并实现功能函数,如mathutil包中Add可导出,multiply不可。使用import导入包,推荐通过go mod初始化模块后以模块路径导入。包可包含init函数,用于自动执行初始化逻辑。遵循规范可提升代码复用与维护性。

在 Go 语言中,包(package)是组织代码的基本单元。通过创建和使用包,可以实现代码的模块化、复用和维护。Go 的包机制简单直观,只要理解目录结构和导入规则,就能高效地管理项目。
理解 Go 包的基本概念
每个 Go 文件都必须属于一个包,包名通常与所在目录同名。使用 package 关键字声明包名,一般放在文件第一行。
main 包比较特殊,它是程序的入口点,包含 main 函数的包必须声明为 package main。其他用于被导入的包则使用自定义名称。
包中的标识符(如变量、函数、结构体)如果首字母大写,则对外可见(导出),否则仅在包内可见。
立即学习“go语言免费学习笔记(深入)”;
创建自定义包
假设我们要创建一个名为 mathutil 的工具包,用于提供一些数学辅助函数。
- 创建项目目录,例如:myproject/
- 在项目下新建包目录:myproject/mathutil/
- 在该目录下创建文件 math.go
- 编写代码:
package mathutil// Add 返回两个整数的和 func Add(a, b int) int { return a + b }
// multiply 是小写,仅在包内可用 func multiply(a, b int) int { return a * b }
这样就创建了一个可复用的包。Add 函数可被外部调用,multiply 则不可。
导入并使用自定义包
在主程序中导入并使用我们创建的包。
- 在项目根目录创建 main.go
- 内容如下:
package mainimport ( "fmt" "./mathutil" // 相对路径导入(适用于老版本或特定构建环境) // 或使用模块方式导入,推荐做法 )
func main() { result := mathutil.Add(3, 5) fmt.Println("3 + 5 =", result) }
注意:现代 Go 项目推荐使用模块(go mod)来管理依赖。
在项目根目录执行:
Metafox 是一个企业内容管理系统,使用一个特别的模板系统,你可通过一些特定的设计和代码来轻松创建 Web 网站,内容存储在 SQL 关系数据库,通过 Web 进行管理,简单、快速而且高效。 Metafox 0.9.1 发布,该版本改用一种更棒的 URL 风格,实现了 RSS 源(可包含远端网站内容到 Metafox 段中),重定向老的访问密钥到新的密钥,增加 RotateAntispam 技
go mod init myproject
然后修改 import 为:
import "myproject/mathutil"
此时 Go 会根据模块路径查找本地包。
包的初始化与 init 函数
每个包可以包含一个或多个 init() 函数,用于包的初始化工作。init 函数没有参数和返回值,不能被显式调用。
例如在 mathutil 包中添加:
func init() {
println("mathutil 包已初始化")
}
当该包被导入时,init 函数会自动执行,常用于设置默认值、注册驱动等操作。
基本上就这些。Go 的包设计简洁,结合 go mod 能很好地支持本地和远程包管理。只要遵循命名规范和目录结构,就能写出清晰可维护的代码。不复杂但容易忽略细节,比如导出符号的大小写规则和模块路径的正确配置。









