goland中go.mod不生效需启用模块支持、确认go111module=on、配置有效goproxy；若依赖未更新，检查文件是否保存、执行go mod tidy或右键download modules；vendor需手动启用vendoring支持。
GoLand 里 go.mod 文件不生效怎么办
常见现象是：新建项目后写了 import，但 IDE 不自动下载依赖，go.mod 里没新增 require 行，终端执行 go mod tidy 却能正常补全。根本原因通常是 GoLand 没启用模块支持或 GOPROXY 配置失效。
- 检查 Settings → Go → GOPATH → 勾选 Enable Go modules integration
- 确认环境变量
GO111MODULE=on已生效（go env GO111MODULE输出应为on） - GOPROXY 必须可访问：Settings → Go → Go Modules → Proxy URL 填
https://goproxy.cn,direct或https://mirrors.aliyun.com/goproxy/,direct；若本地 Git 未安装，会卡在exec: "git": executable file not found in %PATH%错误，需先装 Git 并加入系统 PATH
依赖添加后 go.mod 没更新或版本不对
IDE 自动导入包时，有时写入的版本不是最新稳定版，或 go mod tidy 后仍残留 // indirect 标记——这说明该依赖未被直接引用，只是间接传递进来。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 手动触发同步：右键项目根目录 → Go Modules → Download modules，或终端运行
go get -u github.com/gin-gonic/gin@v1.12.0（指定版本） - 清理冗余：执行
go mod tidy -v查看哪些包被删/加；若某包被标记// indirect且你确实在代码中直接用了它，说明 import 路径写错或未保存文件（GoLand 不解析未保存的 import） - 避免版本漂移：不要依赖
go get默认拉 latest，生产环境建议用@vX.Y.Z显式锁定
多个模块共存时 replace 和 exclude 怎么配
replace 和 exclude 只在当前模块是主模块（即执行命令的目录下有 go.mod 且未被其他模块嵌套）时才生效。Goland 不会自动帮你写这些指令，必须手改 go.mod。
-
replace github.com/old/pkg => ./local-fix：指向本地路径，调试时常用；注意路径是相对go.mod的，不是项目根目录 -
exclude github.com/broken/lib v1.2.3：防止某个特定版本被间接引入；但若其他依赖强制要求该版本，go build仍会失败 - 改完
go.mod后必须立即执行go mod tidy，否则 Goland 的依赖索引不会刷新，补全和跳转会出错
vendor 目录生成后 Goland 还是走缓存
即使运行了 go mod vendor，Goland 默认仍从 $GOMODCACHE 加载包，不会优先读 vendor。要让 IDE 真正离线工作或验证 vendor 正确性，得主动切换模式。
- Settings → Go → Go Modules → 勾选 Enable vendoring support
- 确保项目根目录存在
vendor文件夹，且里面包含完整依赖树（go mod vendor生成） - 此时 IDE 的跳转、补全、重构全部基于
vendor/下的源码，go build -mod=vendor才会真正一致 - 注意：开启 vendoring 后，
go mod tidy不再修改vendor，需手动go mod vendor更新
go.mod 文件是否被正确识别、代理是否可用、以及你有没有保存文件——这三个点漏掉任何一个，都会导致依赖管理看起来“失灵”。
