goland启动时自动同步依赖需满足三条件：goroot手动指定有效路径、go111module=on全局启用、项目根目录存在go.mod；缺一则退化为gopath模式，不触发模块同步。
GoLand 启动时自动同步依赖的关键配置
GoLand 不会“开机即下载”，但只要项目含 go.mod 且环境变量就绪，首次打开或切换模块时就会触发依赖同步——前提是它能正确识别模块上下文。
必须确认三件事：GOROOT 指向有效 Go 安装路径、GO111MODULE=on（推荐全局设置）、工作区根目录下存在 go.mod。缺一不可。
- 在 Settings → Go → GOROOT 中手动指定 Go SDK 路径（不要依赖自动探测，尤其多版本共存时）
- Settings → Go → Tools → Environment 中添加
GO111MODULE=on，避免 IDE 自己启动的子进程读不到 shell 环境变量 - 若项目无
go.mod，右键项目根目录 → “Initialize Go Module”，填入规范模块名（如github.com/yourname/project），否则 GoLand 会退化为 GOPATH 模式，不触发任何模块行为
同步动作实际由后台 gopls 驱动，不是 IDE 主界面控制的。所以打开后看到“Indexing…”或底部状态栏显示 “Loading modules…” 就是正常流程。
VSCode 中 gopls 启动即拉取依赖的条件
VSCode 的 Go 插件依赖 gopls 语言服务器完成依赖解析和下载，它只在打开**含 go.mod 的文件夹**时才启用模块模式。单纯打开单个 .go 文件不会触发。
- 确保工作区是模块根目录（即包含
go.mod的文件夹被设为 VSCode 工作区） - 在
settings.json中显式配置代理："go.toolsEnvVars": {"GOPROXY": "https://goproxy.cn,direct"}，不能只靠系统级go env -w，因为 VSCode 可能不继承终端环境 - 首次打开后若提示 “no required module provides package”，说明
gopls没加载成功，执行Go: Restart Language Server（Cmd/Ctrl+Shift+P） - 禁用
go.useLanguageServer: false是常见误操作——关掉它等于放弃所有模块感知能力
gopls 在启动阶段会调用 go list -m all 获取依赖树，这个过程就是“自动下载”的实际发生点。如果卡住，大概率是 GOPROXY 不可用或 GONOPROXY 漏配私有域名。
IntelliJ IDEA（非 GoLand）导入时依赖不自动下载？
IDEA 的 Go 插件行为更保守：它默认不主动执行 go mod tidy，只做静态索引。所谓“自动下载”其实是你手动点击 “Sync dependencies of Go modules” 或右键 go.mod → “Download modules” 才触发。
- 必须先在 Settings → Go → GOPROXY 填写
https://goproxy.cn,direct，IDEA 不读系统go env - 导入项目时选择 “Import project from external model” → “Go modules”，而不是 “Go project” —— 后者直接走 GOPATH
- 若已有
go.mod但没反应，右键项目 → “Reload project”（不是刷新文件），这会强制重新解析模块 - 注意 IDEA 默认关闭
File Watchers，无法像 GoLand 那样保存时自动go fmt或tidy，需额外配置
它不会在后台静默下载，所有依赖动作都需用户明确介入。这是设计使然，不是 bug。
为什么 go build 和 go run 能自动下载，而 IDE 却卡住？
根本区别在于执行上下文：go build 是命令行工具，直读当前 shell 的 GO111MODULE 和 GOPROXY；IDE 启动的子进程往往脱离 shell 环境，依赖自身配置项覆盖。
- 检查 IDE 启动时是否打印类似
go: downloading github.com/sirupsen/logrus v1.9.0的日志——没有就说明没走模块流程 - 运行
go env对比 IDE 内置终端 vs 系统终端输出，重点看GO111MODULE和GOPROXY是否一致 - 私有模块必须配
GONOPROXY，且值要精确匹配 import 路径前缀（如git.corp.company，不能只写corp.company） -
go.mod里若有replace指向本地路径，但对应目录不存在，gopls会直接报错退出，不继续下载其他依赖
真正容易被忽略的是：IDE 的模块识别完全绑定于文件系统结构，而不是代码内容。哪怕 main.go 里写了 import "github.com/gin-gonic/gin"，只要没 go.mod 或不在模块根下，所有自动下载机制都失效。
