Go module未初始化是IDE无法解析依赖的主因，需在项目根目录执行go mod init；同时确保GOROOT/GOPATH配置一致、gopls等工具已安装、CGO_ENABLED启用，并从终端启动IDE以继承环境变量。
Go module 初始化未执行导致 IDE 无法解析依赖
很多情况下，IDE（如 GoLand、VS Code）显示 undefined 或红色波浪线，不是因为 Go 安装失败，而是项目根目录下缺少 go.mod 文件。IDE 依赖该文件识别模块路径、导入包和版本信息。
- 在项目根目录运行
go mod init，例如go mod init example.com/myapp - 确保
GO111MODULE=on（Go 1.16+ 默认开启，但某些旧终端或 IDE 启动环境可能未继承该变量） - VS Code 中若仍不生效，右键点击
go.mod→ “Go: Reload Packages”，或按Ctrl+Shift+P输入并执行Go: Verify Go Tools
GOROOT 和 GOPATH 配置与 IDE 不一致
IDE 会读取自己的 Go SDK 配置，若与终端中 which go 或 go env GOROOT 返回的路径不一致，就会出现“能编译但 IDE 报错”的割裂现象。
- 在终端执行
go env GOROOT和go env GOPATH，记下输出路径 - GoLand：File → Settings → Go → GOROOT → 点击 folder 图标，选择和终端一致的
GOROOT路径（通常是/usr/local/go或~/sdk/go1.x） - VS Code：打开设置（
settings.json），确认存在"go.goroot": "/usr/local/go"，且值与终端一致；同时检查"go.toolsGopath"是否指向正确的GOPATH（Go 1.16+ 可留空，优先走 module）
Go extension 或 Go plugin 未正确安装/更新
VS Code 的 golang.go 扩展或 GoLand 内置的 Go 插件若版本过旧、损坏或部分工具缺失，会导致符号跳转、自动补全、诊断全部失效。
- VS Code 中运行
Go: Install/Update Tools，勾选全部工具（尤其是gopls、goimports、dlv） -
gopls是核心语言服务器，必须可执行：运行which gopls，若为空则需手动安装：go install golang.org/x/tools/gopls@latest - GoLand 检查：Settings → Plugins → 搜索 “Go”，确认状态为 “Enabled”，版本不低于 2023.3（老版本对 Go 1.21+ 支持不完整）
CGO_ENABLED=0 导致 C 依赖包无法解析（常见于 macOS M1/M2）
某些 IDE（尤其 VS Code + Remote-SSH 或 Docker 开发）默认禁用 CGO，而项目中用了 net、os/user 等底层调用 C 库的包时，gopls 会静默跳过解析，表现为大量标准库符号报错。
立即学习“go语言免费学习笔记（深入）”；
- 检查当前环境：终端执行
echo $CGO_ENABLED，若输出0，则需启用 - VS Code 中，在
settings.json添加："go.toolsEnvVars": { "CGO_ENABLED": "1" } - GoLand：Settings → Go → Build Tags & Vendoring → 勾选 “Enable cgo”
- 注意：启用后若项目含 C 代码，需确保系统有
clang或gcc；macOS 上建议xcode-select --install
go env -w CGO_ENABLED=1 go mod tidy
最常被忽略的是：IDE 启动方式。直接双击图标启动的 GoLand / VS Code，往往不会加载 shell 的 .zshrc 或 .bash_profile 里的 PATH 和 GO* 变量。务必从终端用 goland . 或 code . 启动，才能保证环境一致性。
