Golang自定义包与模块创建详解

本文手把手教你如何在Go语言中创建和使用自定义包与模块：从初始化模块生成go.mod文件、按规范建立mathutils包并导出Add和Multiply函数，到在main.go中正确导入模块路径并调用功能完成计算输出，完整覆盖了Go现代依赖管理的核心实践——既体现了模块机制带来的清晰可控性，又强调了大小写可见性、目录结构和导入路径等易被忽视却至关重要的细节，助你轻松迈出组织化、可复用Go代码的第一步。

在Go语言中，创建自定义包和模块是组织代码、提升复用性和维护性的关键方式。从Go 1.11开始引入的模块（module）机制，让依赖管理变得更加清晰和可控。下面通过一个简单示例，展示如何创建并使用自定义包与模块。

初始化模块

首先，在你的项目目录中初始化一个新的Go模块。

这会在当前目录生成一个 go.mod 文件，内容类似：

module example/myproject
go 1.21

这个文件定义了模块的名称和使用的Go版本。

创建自定义包

在项目根目录下创建一个名为 mathutils 的子目录，并在其中新建一个Go文件：

编辑 calc.go，写入以下内容：

package mathutils
// Add 返回两个整数的和
func Add(a, b int) int {
return a + b
}
// Multiply 返回两个整数的积
func Multiply(a, b int) int {
return a * b
}

注意：函数名首字母大写，才能在包外被访问（Go通过大小写控制可见性）。

在主程序中使用自定义包

回到项目根目录，创建 main.go：

编辑内容如下：

package main
import (
"fmt"
"example/myproject/mathutils"
)
func main() {
a, b := 5, 3
fmt.Printf("%d + %d = %d\n", a, b, mathutils.Add(a, b))
fmt.Printf("%d * %d = %d\n", a, b, mathutils.Multiply(a, b))
}

这里导入的是模块路径下的 mathutils 包，而不是相对路径。

运行程序

执行以下命令构建并运行：

输出结果为：

5 + 3 = 8
5 * 3 = 15

Go会自动解析模块内包的引用，无需额外配置。

基本上就这些。只要遵循模块命名规则、正确组织目录结构，并注意标识符的可见性，就能轻松创建和使用自定义包。这种方式适用于本地开发，也便于后续发布为可复用的公共模块。不复杂但容易忽略。

终于介绍完啦！小伙伴们，这篇关于《Golang自定义包与模块创建详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！