go 1.11起模块成为官方包管理机制，取代gopath；通过go mod init初始化生成go.mod，go get管理依赖版本，go mod tidy同步依赖，模块路径需稳定唯一，私有模块需配置goproxy/goprivate。
Go 语言从 1.11 版本起正式引入 模块（Modules） 作为官方推荐的包管理机制，取代了早期基于 $GOPATH 的依赖组织方式。它让项目具备明确的版本边界、可复用的依赖声明和跨环境一致的构建能力。
模块初始化与 go.mod 文件
在项目根目录执行 go mod init <module-path></module-path> 即可启用模块模式，生成 go.mod 文件。该路径通常是项目的导入路径（如 github.com/username/mylib），应具备唯一性和稳定性，便于他人引用。
- 模块路径不强制要求与代码托管地址一致，但强烈建议保持一致，避免使用者导入时出错
-
go.mod中会自动记录直接依赖及其版本号，间接依赖由 Go 自动推导并写入go.sum保证校验和一致性 - 运行
go build或go test时，Go 会自动下载缺失依赖并更新go.mod
依赖添加、升级与清理
使用 go get 是管理依赖的核心命令。它不仅能添加新包，还能升级或降级已有依赖。
-
go get example.com/pkg@v1.2.3：精确指定版本，写入go.mod -
go get -u example.com/pkg：升级到最新兼容版本（遵循语义化版本规则） -
go get -u=patch example.com/pkg：仅升级补丁版本（如 v1.2.1 → v1.2.5） -
go mod tidy：删除未使用的依赖，补全缺失的间接依赖，同步go.mod和go.sum
构建可复用库的关键实践
若目标是发布一个供他人导入的 Go 库（如 github.com/you/utils），需注意以下几点：
立即学习“go语言免费学习笔记（深入）”；
- 模块路径应与代码仓库地址匹配，并长期稳定；如迁移仓库，需通过
replace或重定向文档引导用户迁移 - 对外暴露的接口应定义在
exported标识符（首字母大写），非导出符号不会被外部包访问 - 提供清晰的
README.md、示例代码（放在example_test.go中可被go doc和go test -run=Example*识别） - 合理使用
//go:build注释控制条件编译，适配不同平台或功能开关
私有模块与代理配置
企业内部或私有仓库的模块可通过 GOPROXY、GONOSUMDB 和 GOPRIVATE 配合使用：
-
GOPROXY=https://proxy.golang.org,direct：优先走公共代理，失败则直连；可替换为私有代理如https://goproxy.example.com -
GOPRIVATE=git.internal.company.com/*：匹配该前缀的模块跳过代理和校验和检查 -
GONOSUMDB=git.internal.company.com/*：对私有域名禁用 checksum 数据库验证（常与 GOPRIVATE 一起设置）
模块机制让 Go 项目真正具备“开箱即用”的依赖可重现性，也使编写可发布、可协作的库变得轻量而可靠。关键在于理解 go.mod 是声明式契约，而非配置文件——它的内容由代码实际依赖决定，而非手动维护。