Git子模块在Go中仅用于源码快照管理，不参与Go模块依赖解析；正确复用方式是将子模块发布为独立Go模块并用go get引入。
Go 本身不支持 Git 子模块作为构建依赖——go build 和 go mod 完全忽略 .gitmodules 和子模块检出状态。你不能靠 git submodule update --init 让 go run 自动识别子模块里的包。
Git 子模块在 Go 项目中实际起什么作用？
它只负责「源码快照管理」，即把另一仓库的某次提交固定到主仓库的某个路径下，方便人工查看、调试或离线开发。Go 的模块系统（go.mod）对此无感知，也不会从子模块路径里解析 import 路径。
- 子模块内容不会被
go list ./...扫描到 -
import "github.com/your/repo/submodule"这种写法会失败，除非该路径已发布为独立 Go 模块并被go.mod显式 require - 如果子模块本身有
go.mod，它只是个普通 Go 模块，和主项目无关；要复用，得走标准依赖声明流程
想复用子模块代码？正确做法是发布为独立模块
别把子模块当“本地依赖”用。如果你控制子模块代码，应将其作为独立 Go 模块维护：
- 确保子模块根目录有
go.mod，模块路径如github.com/you/utils - 主项目运行
go get github.com/you/utils@main（或指定 tag/commit） - 导入时写
import "github.com/you/utils"，而非相对路径或子模块本地路径 - 子模块更新后，主项目需显式
go get -u github.com/you/utils并提交新的go.sum
这样既能版本锁定，又兼容 go build、CI 缓存、代理（如 GOPROXY）等所有 Go 生态机制。
