GoLand依赖报错90%源于go.mod配置错误：module路径须与远程仓库地址严格一致；replace必须用相对路径且目标含go.mod；GOPROXY/GOSUMDB需在IDE中显式配置，不可仅依赖系统变量。
GoLand 里依赖报错，90% 不是 IDE 问题，而是 go.mod 的 module 路径、replace 写法或代理配置没对齐底层 Go 工具链规则。
go.mod 的 module 行必须和远程仓库地址完全一致
比如你 push 到 GitHub 的地址是 github.com/yourname/api-server，那 go.mod 第一行就必须是：module github.com/yourname/api-server。哪怕本地文件夹叫 myapi，也不能写成 module myapi。
常见错误现象：
verifying github.com/yourname/api-server@v0.2.0: checksum mismatch- CI 构建失败，但本地
go build成功 - GoLand 提示 “Unresolved reference”，import 能跳转却无法补全
根本原因：Go 工具链用 module 值生成校验路径，跟实际 Git 地址不一致时，go.sum 校验直接失败。IDE 只是把错误藏在后台日志里。
立即学习“go语言免费学习笔记（深入）”；
replace 路径必须是相对路径，且目标含有效 go.mod
本地调试多模块项目时，replace 必须指向当前 go.mod 的相对位置。例如主模块在 ./service，工具库在 ../utils，则 service/go.mod 末尾要加：
replace github.com/yourname/utils => ../utils
注意三点：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
../utils目录下必须有go.mod（哪怕只是module github.com/yourname/utils），否则 Go 会 fallback 到 legacy mode - 不能写成
~/projects/utils或C:\dev\utils——replace不支持绝对路径或~缩写 -
replace只影响当前模块构建，不会出现在go list -m all的下游依赖树中，也不会被go mod vendor收录
GOPROXY 和 GOSUMDB 必须在 GoLand 里显式配置
GoLand 底部 Terminal 执行 go env GOPROXY 和 go env GOSUMDB，确认值不是空或默认的 https://proxy.golang.org。国内常用配置是：
GOPROXY=https://goproxy.cn,direct GOSUMDB=gosum.io+ce6e75650+AY5qEHUk/qmHc5btzW45JVoENfazw8LielDsaI+lEbq6
关键点：
- 仅设置系统环境变量不够，GoLand 的 Settings → Go → Go Modules → Environment 里必须填上相同值
- 私有仓库还需配置
GOPRIVATE，例如go env -w GOPRIVATE="gitlab.example.com" - 若用自定义域名（如
mycorp.internal/lib），需确保 DNS 可解析、HTTPS 可访问，并在根路径提供<meta name="go-import" ...>标签
多模块项目依赖统一靠根模块锚定版本
子模块各自管自己的 require 是危险的。Go 构建时会压平整个依赖图，如果 service require v1.5.0，data require v1.8.0，最终选 v1.8.0；但若 data 又 require 了强制要 v2.0.0 的包，而 service 还卡在 v1.x，就会触发编译失败或 panic。
正确做法：在项目根目录建一个纯管理用的 go.mod，只干三件事：
- 声明所有子模块和关键第三方依赖（如
github.com/sirupsen/logrus v1.9.3） - 用
replace指向本地子模块（如replace example.com/project/service => ./service） - 不放任何
.go文件
发布前删掉 replace，打 tag 后 go mod tidy 会自动把 v0.0.0 升级为真实语义化版本。
真正容易被忽略的是：别只信 go list -m all 显示的“最终版本”，它看不到谁在拉旧版。查“谁在拖后腿”，得用 go list -m -u all 或逐个进子模块执行 go mod graph | grep。
