如何使用Golang创建自定义包_Golang包的创建与使用方法_网络技术

发布时间 - 2026-01-29 00:00:00 点击率：次

Go语言中import路径严格对应文件系统路径，包名必须与目录名一致且全小写，导出标识符首字母须大写，导入路径以模块根目录为基准，init函数执行顺序不可控。

Go 语言中没有“安装包”或“发布包”的中间步骤，import 路径直接对应文件系统路径，自定义包本质就是一组放在同一目录下的 .go 文件，只要路径可寻、命名合规、导出正确，就能被其他代码直接引用。

Go 不允许包名含大写字母或下划线（如 my_pkg 或 MyPackage），否则 go build 会报错 invalid package name。目录名也必须完全匹配——不是“建议”，而是强制约束。

Go 的可见性由标识符首字母决定：大写 = 导出（public），小写 = 包内私有。这点和 Python 的 _ 前缀或 Java 的 public 关键字逻辑不同，容易误以为“只要在同一个模块里就能用”。

func DoWork() 可被外部调用；func doWork() 只能在 utils 包内部使用
即使两个包在同一目录（不推荐），也不能绕过导出规则访问对方的小写名
结构体字段也遵循同样规则：type Config struct { Host string; port int } 中只有 Host 可被外部读写，port 完全不可见

运行 go mod init example.com/myapp 后，所有 import 语句中的路径都以 example.com/myapp 为基准。哪怕你在 myapp/utils 目录下执行 go run main.go，也不能写 import "utils"。

正确写法是 import "example.com/myapp/utils"
如果想用相对路径测试（比如没推送到远程），可用 replace 在 go.mod 中重定向：replace example.com/myapp/utils => ./utils
本地开发时常用 go run -mod=mod main.go 配合 replace，避免反复 go mod tidy 拉取不存在的远程路径

最常被忽略的是：包初始化顺序不可控，init() 函数执行时机只保证在 main() 之前、且按导入依赖图拓扑排序，但同级包之间

无明确先后。若你的自定义包依赖另一个包的 init() 侧边效应（比如全局配置加载），很可能在某些构建环境下静默失败。