goland依赖路径报错90%源于go.mod的module行与远程git地址不一致：module必须严格匹配如github.com/yourname/api-server，否则触发checksum mismatch、ci失败、unresolved reference；replace须为相对路径且目标含go.mod；goproxy和gosumdb需通过go env -w配置，ide界面设置无效。
GoLand 依赖路径报错，90% 是 go.mod 的 module 行和真实 Git 地址不一致，不是 IDE 设置问题。
为什么 go.mod 的 module 必须严格匹配远程仓库地址
Go 工具链用 module 值生成校验路径、计算 go.sum hash、解析 go get 导入路径。一旦写成 module myapi，但实际推送到 github.com/yourname/api-server，就会触发 checksum mismatch 或 Unresolved reference —— IDE 只是把底层错误藏在日志里，不报红也不提示。
常见错误现象：
-
go get github.com/yourname/api-server@v0.2.0报verifying ...: checksum mismatch - CI 构建失败，但本地
go build成功 - GoLand 能跳转到
import包，却无法补全函数、标红但无错误提示
修复方式：
- 打开
go.mod，第一行必须是module github.com/yourname/api-server（和 GitHub/GitLab URL 完全一致，大小写、连字符都不能错） - 如果已推过旧版本，先改
go.mod，再执行go mod tidy，最后git commit -am "fix module path" - 别用本地文件夹名（如
myproject）或组织名（如company）代替完整域名路径
replace 路径必须是相对路径且目标含 go.mod
本地调试多模块时，replace 写错会导致依赖静默 fallback 到旧版本或直接失效，IDE 补全和构建行为不一致。
例如主模块在 ./service，工具库在 ../utils，则 service/go.mod 末尾应写：
replace github.com/yourname/utils => ../utils
注意三点：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
-
../utils目录下必须存在有效的go.mod（哪怕只有module github.com/yourname/utils一行） - 不能写成
~/projects/utils或C:\dev\utils——replace不支持绝对路径或~缩写 -
replace只影响当前模块构建，不会出现在go list -m all输出中，也不会被go mod vendor收录
GoLand 代理和校验开关必须通过 go env -w 设置
GoLand 设置界面填的 GOPROXY 和 GOSUMDB 不生效——它只读系统级 go env 配置，不继承 IDE 界面输入。
验证方式：在 GoLand 底部 Terminal 执行：
go env GOPROXY<br>go env GOSUMDB
如果输出是空、direct 或默认的 https://proxy.golang.org，就说明没生效。正确做法是：
- 国内用户执行：
go env -w GOPROXY=https://goproxy.cn,direct和go env -w GOSUMDB=sum.golang.org - 私有模块加：
go env -w GOPRIVATE=git.example.com/* - 改完后删掉项目里的
go.sum和vendor/（如有），再跑go mod tidy
GOROOT 配错会连锁导致 gopls/dlv 失效
GOROOT 指向错误，表面看只是 “No Go SDK found”，实际后果是 gopls 启动失败、补全失效、调试器 dlv 报 fork/exec: no such file or directory。
排查步骤：
- 终端执行
which go（macOS/Linux）或where go（Windows），得到路径如/usr/local/go/bin/go - 把该路径去掉末尾
/bin/go，即/usr/local/go，才是正确GOROOT - GoLand Settings → Go → GOROOT → + → 粘贴该路径，**不要点 Browse，不要选 bin 子目录**
- 重启 GoLand（仅 Reload project 不够）
- 验证：新建
main.go，写fmt.Println("ok")，确认能识别fmt并跳转到源码
容易被忽略的是：GOROOT 目录下必须有 src/、bin/、pkg/ 三个子目录；若缺失 src/（比如某些精简安装包），必须重装官方 MSI/ZIP 包——复制其他版本的 src 会导致 runtime 校验失败。
