创建独立shared module并用Git管理版本,通过go mod init初始化并打tag发布;在其他项目中引入依赖后可直接导入使用;开发时用replace指向本地路径调试;遵循语义化版本保证兼容性,配合GOPRIVATE处理私有仓库。核心是拆分模块、版本控制与replace调试协同。

在Go项目中,当多个module需要复用相同代码时,常见做法是将公共部分抽离成独立的shared module。Go语言本身通过module机制支持这种复用,结合版本管理和模块路径设计,可以实现高效、可维护的代码共享。
1. 创建独立的shared module
将通用功能(如工具函数、错误类型、配置结构、数据库模型等)提取到一个单独的Git仓库中:
shared-utils/├── go.mod
├── utils.go
└── logger/
└── logger.go
初始化module:
go mod init github.com/your-org/shared-utils发布版本(推荐使用Git tag):
立即学习“go语言免费学习笔记(深入)”;
git tag v0.1.0 && git push origin v0.1.02. 在其他module中引入shared module
在业务module的go.mod中添加依赖:
在代码中直接导入使用:
import "github.com/your-org/shared-utils/logger"运行go mod tidy自动下载并更新依赖。
3. 使用replace进行本地开发调试
在开发阶段,若需对shared module做修改并实时测试,可在主项目的go.mod中使用replace指令:
这样会从本地路径加载代码,避免频繁提交和打tag。上线前记得移除replace,使用正式版本。
4. 版本管理与兼容性建议
- 遵循语义化版本规范(v1.0.0, v1.1.0等),避免非兼容更新破坏下游项目
- 公共接口尽量保持稳定,变更时提供过渡期或封装层
- 私有仓库可通过SSH配置访问权限:
replace或设置GOPRIVATE环境变量
基本上就这些。核心思路是:拆出独立module + Git版本控制 + replace本地调试。结构清晰,维护成本低,适合团队协作。不复杂但容易忽略的是版本管理和replace的正确使用。










