goland不自动识别git子模块需手动导入：在project structure → modules中导入子模块目录并勾选go module；子模块更新后须右键其根目录→reload project；replace需配合go mod tidy且避免被ide误删；删除子模块须执行deinit、清理目录及.gitmodules并tidy。
Git子模块在GoLand里不自动识别怎么办
GoLand默认不会递归扫描子模块目录，即使你用git submodule add拉了依赖，IDE也只把主项目当“Go项目”，子模块里的go.mod会被忽略，导致import标红、跳转失效、代码补全缺失。
解决方法不是等IDE自动发现，而是手动告诉它哪些路径是独立模块：
- 打开
File → Project Structure → Modules，点击+→Import Module - 选中子模块所在目录（比如
vendor/github.com/some/lib），勾选Go module - 确保该模块的
Go SDK与主项目一致，否则编译报错 - 重复操作，为每个需要开发调试的子模块单独导入
子模块更新后GoLand缓存没刷新导致build失败
执行git submodule update --remote拉了新代码，但GoLand仍按旧版本解析，常见报错：undefined: some.NewFunc或cannot find package——本质是IDE没重载子模块的go.mod和源码索引。
必须主动触发重载：
- 右键子模块根目录 →
Reload project（不是整个项目，只点子模块） - 或者在
Project Structure → Modules里选中该模块，点击Reload按钮 - 如果用了
replace指向本地子模块路径，确认go mod tidy已运行，且go.mod里replace行未被GoLand自动删掉
子模块里改代码却推不到上游仓库
你在子模块目录里写了新功能，git commit也成功了，但git push提示fatal: You are not currently on any branch——这是Git子模块默认处于“分离头指针”状态，没绑定到任何分支。
要让修改可推送，必须先切回一个真实分支：
- 进入子模块目录：
cd vendor/github.com/some/lib - 运行
git checkout main（或develop等目标分支） - 再提交：
git add . && git commit -m "feat: xxx" - 最后
git push origin main - 回到主项目，
git add vendor/github.com/some/lib提交子模块的commit hash变更
GoLand里怎么安全地删除一个子模块
直接删vendor/xxx文件夹会导致Git记录残留，下次git submodule update又把它拉回来，还可能破坏go mod vendor一致性。
正确流程分三步，缺一不可：
- 执行
git submodule deinit -f vendor/github.com/some/lib（清除.git/config和.git/modules里的注册） - 执行
rm -rf .git/modules/vendor/github.com/some/lib vendor/github.com/some/lib - 编辑
.gitmodules文件，删掉对应section，并git add .gitmodules提交 - 最后运行
go mod tidy，确保go.mod里不再引用该模块
子模块不是“插件式依赖”，它本质是嵌套Git仓库+硬编码路径引用，任何操作都得同时兼顾Git层和Go模块层，漏掉一层就容易卡住。
