GoLand多模块项目依赖解析失败的三大主因是GO111MODULE未全局生效、go.mod的module声明与实际路径不一致、replace路径错误；需分别通过环境变量加固、严格匹配远程地址、使用相对路径并确保目标含go.mod来解决。
多模块项目在 GoLand 中无法解析依赖，根本不是 IDE 配置漏了哪项，而是 GO111MODULE 没真正生效、go.mod 的 module 声明和实际路径不一致、replace 路径写错这三处中的至少一处出了问题。
GO111MODULE=on 必须全局+IDE 双重加固
GoLand 启动时不会自动继承 shell 的环境变量，即使你在终端里执行过 go env -w GO111MODULE=on，IDE 内部的 Terminal 和构建流程仍可能 fallback 到 GOPATH 模式。
- 先在系统终端运行：
go env -w GO111MODULE=on（Windows PowerShell / macOS/Linux bash/zsh 均适用） - 再进 GoLand →
File → Settings → Go → Go Environment，在 Environment 字段手动添加：GO111MODULE=on - 打开 GoLand 底部 Terminal，执行：
go env GO111MODULE，输出必须是on，不能是auto或空 - 别用
auto：它在跨目录操作（比如从根目录切到./cmd/app1）时会误判当前不在模块内，直接禁用模块支持
go.mod 的 module 行必须严格匹配远程仓库地址
这是 90% “Unresolved reference” 和 checksum mismatch 错误的根源。Go 工具链靠这个字符串生成校验路径，跟 Git 地址对不上，go.sum 就会拒绝验证。
- 如果代码托管在
github.com/yourorg/api，那api/go.mod第一行必须是：module github.com/yourorg/api - 不能写成
module api、module myapi或本地路径如module ./api - CI 失败但本地
go build成功？大概率是本地 GOPATH 模式偶然绕过了校验，而 CI 环境强制模块模式暴露了问题 - GoLand 不报红但 import 无法补全？检查
go list -m all是否能正常列出该模块——如果报no required module provides package，说明 module 声明已失效
replace 路径必须是相对路径且目标含 go.mod
本地多模块间调试常用 replace，但它极易写错。错误写法会导致 Go 退化到 legacy 模式，依赖丢失、版本混乱、go mod tidy 不识别。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 假设主模块在
./service，想替换github.com/yourorg/utils为本地../utils，则service/go.mod末尾应写：replace github.com/yourorg/utils => ../utils -
../utils目录下必须存在有效的go.mod（哪怕只是module github.com/yourorg/utils） - 禁止使用绝对路径：
/home/user/utils、C:\dev\utils、~/utils全都不行 -
replace只影响当前模块构建，不会出现在go list -m all的下游依赖树中，也不会被go mod vendor收录
GoLand 依赖图显示为空或不完整？先确认 go list 执行上下文
依赖图不是静态分析结果，而是实时调用 go list -json -deps 生成的。任何破坏该命令执行的配置都会导致图表失败。
- 右键
go.mod文件 → “Show Dependencies Diagram”，不是右键项目根目录 - 确保 GoLand Terminal 中能跑通：
go list -m all和go list -json -deps ./... - 若图表只显示标准库，大概率是你在编辑一个未被任何
go.mod声明为依赖的包——GoLand 默认只展示「当前文件实际参与构建」的依赖链 - 多模块项目需对每个含
go.mod的目录单独右键 → “Mark Directory as → Go Modules Root”，否则 IDE 不知道哪些是独立模块
最易被忽略的是：模块声明与 Git 地址不一致的问题，往往藏在日志里不报错，只表现为 import 提示“跳转可用但无补全”；而 replace 路径写错时，go mod tidy 也不报错，只是静默忽略——得靠 go list -m all 和 go list -deps 才能验证是否真被识别。
