Go不支持Git子模块自动解析，需手动初始化子模块并用replace绑定本地路径，否则导入失败；CI需配置递归拉取子模块，否则构建静默失败。
Go 本身不支持 Git 子模块的自动解析或构建集成——go build、go mod tidy 完全无视 .gitmodules 文件，也不会递归拉取子模块内容。你必须手动确保子模块已检出且路径正确，否则 Go 工具链会按普通目录（甚至空目录）处理，导致包导入失败或编译报错。
Git 子模块未初始化导致 import 路径无法解析
常见现象：项目中 import 了类似 "github.com/yourorg/project/submodule" 的路径，但 go build 报 no required module provides package 或直接提示找不到包；而该路径实际对应的是本地子模块目录，不是远程 Go 模块。
- Git 子模块默认不会随
git clone自动检出，需显式运行git submodule init && git submodule update - 若子模块路径在 Go 代码中被当作模块路径引用（如
import "example.com/repo/utils"），但该子模块未发布到 Go Module Proxy，也未在go.mod中用replace显式指向本地路径，则go mod tidy会失败 - 推荐做法：子模块只用于存放非 Go 模块资源（如脚本、配置、C 库头文件），或明确将其作为独立 Go 模块管理，并通过
replace绑定本地路径
用 replace 将子模块绑定为本地 Go 模块
当子模块本身是一个合法 Go 模块（含 go.mod），且你想在父项目中直接引用其代码（而非仅作静态资源），就必须在父项目的 go.mod 中添加 replace 指令，否则 Go 不会识别子目录为有效模块源。
例如子模块路径为 ./internal/tools，其 go.mod 声明模块名为 example.com/tools：
