IDE报错“undefined”但终端能编译，本质是环境没对齐：IDE未继承终端的GOROOT、GO111MODULE、CGO_ENABLED等变量，导致标准库路径缺失、模块模式关闭、cgo禁用。
IDE报错“undefined”但终端能编译，本质是环境没对齐
这不是代码问题，而是 IDE 启动时压根没读到你终端里配置好的 GOROOT、GO111MODULE 或 CGO_ENABLED。图形界面程序（如 GoLand、VS Code）通常不继承 shell 的环境变量，导致它用空环境去解析代码——标准库路径找不到、模块模式关着、cgo 被静默禁用，于是 time.Duration、net.Conn 全变红色。
- 先在终端运行
go env GOROOT GOPATH GO111MODULE CGO_ENABLED，记下输出 - GoLand：进入 File → Settings → Go → GOROOT，手动设为和终端一致的路径；再检查 Go Modules → Enable Go Modules integration 是否勾选
- VS Code：打开
settings.json，确认有"go.goroot": "/usr/local/go"，且"go.toolsEnvVars"显式声明关键变量，例如："go.toolsEnvVars": { "GO111MODULE": "on", "CGO_ENABLED": "1" } - Mac/Linux 用户若用 zsh/fish，从终端启动 VS Code：
code .，比双击图标更可靠
gopls 启动失败或补全卡死，90% 是模块没初始化或工具链错位
gopls 不是“装了就行”的插件，它靠 go list -json 和项目根目录的 go.mod 驱动。没有 go.mod，它就退化成 GOPATH 模式，一遇到多版本依赖或 vendor 目录就乱套；工具不在 PATH 或版本不匹配，它直接拒绝服务。
- 进项目根目录，执行
go mod init example.com/myapp（哪怕只是临时命名） - 运行
which gopls，如果为空，用go install golang.org/x/tools/gopls@latest安装；别信某些教程说“让插件自动装”，它常装错小版本 - VS Code 中按
Ctrl+Shift+P，输入并执行Go: Install/Update Tools，勾选全部，尤其gopls和dlv - 如果补全仍慢，加一行配置开启诊断：
"go.goplsArgs": ["-rpc.trace"]，然后看 Output 面板里的gopls日志
调试器启动失败或断点不命中，别急着重装 dlv
VS Code 的 dlv 调试不是简单跑 dlv debug，它会额外加参数、切工作目录、读 launch.json 里的构建选项。常见失败提示如 could not launch process: fork/exec /proc/self/exe: operation not permitted，其实是 seccomp 限制，不是 dlv 本身坏了。
- 调试前务必先运行
go mod tidy，缺依赖时 dlv 编译失败，但错误常被吞掉 - 检查
.vscode/launch.json："mode": "exec"必须配"program"指向已存在的二进制；"mode": "auto"或"debug"才适合源码调试 - Linux 容器或 WSL 环境下，加
"dlvLoadConfig"配置避免 seccomp 报错："dlvLoadConfig": { "followPointers": true, "maxArrayValues": 64 } - GoLand 用户请确认：Settings → Go → Debugger → “Use native debug adapter” 已启用，否则可能 fallback 到旧版 GDB 模式
多个 Go 版本混用时，IDE 自动识别错版本？用 goenv 切环境
手动改 GOROOT 或软链接 /usr/local/go 极易出错，而且 IDE 只认启动那一刻的值。一旦你切了 Go 版本但忘了重启 IDE，它还在用旧 SDK 解析语法，go 1.22 新增的泛型语法就直接标红。
立即学习“go语言免费学习笔记（深入）”；
- 装
goenv：git clone https://github.com/syndbg/goenv.git ~/.goenv，加~/.goenv/bin到PATH开头 - 安装多个版本：
goenv install 1.20.15 1.22.0，然后在项目根目录执行goenv local 1.22.0，生成.go-version - 验证：
go version和goenv which go输出必须一致；IDE 启动后，检查右下角或状态栏显示的 Go 版本是否匹配 - 别用
goenv global，它会让所有项目强制绑死一个版本，违背多项目隔离初衷
最常被忽略的一点：IDE 缓存不会随 go.mod 变更自动刷新。遇到诡异的符号解析失败，先试 Go: Reload Packages（VS Code）或 File → Reload project（GoLand），而不是立刻重装插件或重装 Go。
