根本原因是ide未同步模块状态，需刷新缓存或重启语言服务器；goland用invalidate caches，vs code执行go: reload window并确认goproxy生效。
GoLand 或 VS Code 里 go mod tidy 成功但依赖仍标红
根本原因不是下载失败，而是 IDE 没读到你刚更新的模块状态。GoLand 和 VS Code 的 Go 扩展各自维护一套缓存和模块索引，和终端里执行的 go mod tidy 不自动同步。
- GoLand：右键项目根目录 → Synchronize，或
File → Invalidate Caches and Restart → Invalidate and Restart - VS Code：确保 Go 扩展已启用，打开命令面板（
Ctrl+Shift+P）→ 输入Go: Install/Update Tools→ 全选并安装；再运行Go: Reload Window - 检查 IDE 终端是否继承了正确的环境变量：在 IDE 内置终端中执行
go env GOPROXY，输出必须是你设的代理地址（如https://goproxy.cn,direct），否则需在 IDE 设置里手动填入 GOPROXY
VS Code 中 go install 工具装不上，提示 module lookup failed
这不是工具本身的问题，而是 go install 在 Go 1.21+ 默认走模块模式，且会严格遵循 GOPROXY 和 GOPRIVATE 配置。一旦代理不可达或私有域名没加进 GOPRIVATE，就会直接报错。
- 先确认
go install golang.org/x/tools/gopls@latest这类命令是否在终端里能跑通；如果终端可以、VS Code 不行，说明 IDE 环境变量没生效 - 若用的是私有仓库工具（比如公司内部的 linter），必须显式设置：
go env -w GOPRIVATE=git.internal.company.com - 避免用
go get替代go install—— 后者才真正写入$GOPATH/bin，前者只更新go.mod，且从 Go 1.21 起已被标记为 legacy
go mod download 显示成功，但 go build 仍报 import not found
常见于模块路径与实际导入路径不一致，尤其在重命名项目、移动 go.mod 或使用 replace 后。Go 不会自动修正 import path，它只认 go.mod 里声明的 module 名和源码中的 import 字符串是否完全匹配。
- 运行
go list -m all，看输出里有没有你期望的模块路径；如果显示的是旧路径（比如github.com/old/repo），但代码里写的是github.com/new/repo，就必然报错 - 用
go mod edit -module github.com/new/repo更新模块声明，再删掉go.sum（校验文件会自动重建） - 如果有
replace，确认它指向的本地路径存在且可读：replace github.com/old/repo => ./local-copy中的./local-copy必须是相对当前go.mod的有效路径
为什么 go mod tidy 在终端里什么也不输出，却没下载依赖？
这通常意味着模块缓存已“认为”所有依赖就绪，但它可能被污染、过期，或 GO111MODULE 实际未启用。最典型的假成功场景是：缓存里有旧版本，而 go.mod 里写了新版本，但 Go 没触发更新。
- 先运行
go env GO111MODULE，必须输出on；如果是auto，某些子目录下可能退回到 GOPATH 模式 - 强制刷新：执行
go clean -modcache清空缓存，再跑go mod tidy -v（加-v看详细日志） - 如果项目根目录存在
vendor/目录，Go 默认跳过代理和远程拉取——删掉vendor或临时加-mod=mod参数：go mod tidy -mod=mod
GOPRIVATE 漏配导致的静默失败。这些环节没有明显报错，但就是不工作。
