最常踩的坑是环境隔离不实导致运行出错、gopls报错、go install乱放及CI失败；根源在于GOROOT硬切换、GOPATH滥用、模块路径与工作区根目录不一致。
多个 Go 项目共用一套环境时，最常踩的坑不是编译失败，而是 go build 成功却运行出错、gopls 报 no module found、go install 二进制乱放，甚至 CI 脚本在本地能过、流水线里挂掉——根源不在代码，而在环境隔离没做实。
Go 版本混用时别硬切 GOROOT
直接把 /usr/local/go 替换成另一个版本，所有项目立刻受影响，尤其当某个脚本依赖 go version 输出格式或特定 go tool 行为时，CI 构建会静默失败。
- 用
gvm管理多版本：gvm install 1.21.0→gvm use 1.21.0，每个版本独立编译、互不干扰 - 或用
asdf（需装asdf-plugin）：支持项目级.go-version文件，终端自动切换 - VS Code 的集成终端默认不加载 shell hook，得手动在设置里开
"terminal.integrated.profiles.linux": { "bash": { "path": "/bin/bash", "args": ["-i"] } }才能生效
GOPATH 不是摆设，但不该全局 export
Go Modules 开启后，go build 不再依赖 GOPATH 查源码，但它仍控制 go install 输出位置和 go get 的默认下载路径。乱设 GOPATH 会导致工具链二进制和项目依赖缓存打架。
- 统一设
GOPATH=$HOME/go，只放go install生成的工具（如golint、stringer） - 用
GOBIN=$HOME/.local/bin显式分离二进制，避免污染$PATH或覆盖系统命令 - 真要隔离不同网络环境的项目（比如内网模块不能连公网）？别
export GOPATH=xxx，改用 alias：alias go-intern='GOPATH=/path/to/intern go'
VS Code 打开多项目时 gopls 总报错
常见现象：打开整个 monorepo 目录，gopls 提示 invalid module path 或跳转不到 replace 后的本地包——它根本没识别到你当前编辑的文件属于哪个模块。
立即学习“go语言免费学习笔记（深入）”；
- 每个子项目必须有独立
go.mod，且 VS Code 工作区根目录必须是该go.mod所在目录 - 不要用 “Open Folder” 打顶层目录；要么为每个模块单独开窗口，要么用 Multi-root Workspace，并在每个 root 下配置
"go.toolsEnvVars": { "GOFLAGS": "-mod=mod" } - 跨模块引用必须走
go work use ../other-module生成go.work，否则go build和gopls行为不一致
真正难的不是让单个项目跑起来，而是确保 go list -m all、go mod graph、gopls 日志、CI 中的 go test -race 全部看到同一套模块视图——这要求版本、模块路径、工作区根目录三者严格对齐，缺一不可。
