GoLand重装系统后GOROOT需手动设置为go env GOROOT输出的完整路径（如/opt/homebrew/Cellar/go/1.23.0/libexec），必须包含src/pkg/bin三目录，且末尾不可带/bin；否则报“SDK not found”或标准库类型标红。
GOROOT未设置或识别失败
GoLand重装系统后不会自动扫描Go安装路径，which go输出的/opt/homebrew/bin/go只是软链接，真正需要的是go env GOROOT返回的完整路径（如/opt/homebrew/Cellar/go/1.23.0/libexec）。选错会导致IDE报“SDK not found”或标准库类型（如time.Duration）标红。
实操建议：
- 终端执行go env GOROOT，复制完整输出
- GoLand → Settings → Go → GOROOT → 点击文件夹图标粘贴该路径（末尾不能带/bin）
- 手动检查该路径下是否存在src、pkg、bin三个目录——缺一不可
- 若仍报错，重启GoLand并确认是否勾选了“Use GOPATH that is configured in system environment”（此项会覆盖手动设置）
go.mod存在但IDE不识别模块
常见于Git克隆项目或迁移旧工程，GoLand未激活Modules上下文，即使go.mod真实存在，也会显示“go.mod file not found”。这不是文件问题，而是IDE缓存未加载模块元数据。
实操建议：
- 右键项目根目录 → Reload project（不是“Reload from Disk”）
- 确保go.mod首行是合法module example.com/myapp，不能以空行或//注释开头
- 临时终端执行go mod download，再回IDE点击右上角Load（小闪电图标）
- 若无效，进Settings → Go → Modules → 取消勾选Enable Go modules integration，Apply后再勾选启用
代码补全/跳转失效且gopls报错
症状包括：Ctrl+Click跳不到定义、输入fmt.无提示、go fmt不自动触发。根本原因是gopls未安装或路径未绑定到当前GOROOT/GOPATH，而非IDE插件故障。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
实操建议：
- 终端运行go install golang.org/x/tools/gopls@latest（必须用go install，go get已弃用）
- GoLand → Settings → Go → Language Server → 选择Use custom gopls binary，路径填$(go env GOPATH)/bin/gopls
- 检查go env GOPATH输出路径下bin/gopls是否存在且有执行权限（必要时chmod +x）
- 关闭Settings → Editor → General → Smart Keys → Go → Format on save以外的格式化选项，避免与gofmt冲突
运行时环境变量获取为空
代码中os.Getenv("MY_ENV_VAR")返回空字符串，通常不是程序逻辑问题，而是GoLand运行配置未注入变量，或内置终端未继承系统PATH。
立即学习“go语言免费学习笔记（深入）”；
实操建议：
- 点击右上角运行配置下拉框 → Edit Configurations → 在Environment variables字段添加MY_ENV_VAR=my_value
- Settings → Tools → Terminal → 修改Shell path为系统终端（如/bin/zsh或cmd.exe），否则内置终端无法读取~/.zshrc中的export
- 编译时需注入变量（如版本号），必须用-ldflags="-X 'main.Version=$(MY_ENV_VAR)'"，不能依赖os.Getenv在编译阶段读取
GoLand配置失效的根因往往不在表面报错位置，而在于GOROOT路径是否真实包含标准库、gopls二进制是否与当前GOPATH对齐、以及环境变量是否通过运行配置而非仅终端注入——这三处错一个，整个开发流就断掉。
