应检查goroot和gopath是否残留旧配置：运行go env goroot和go env gopath核对路径，用echo $path | tr ':' '\n' | grep -e '(go|go)'排查冗余路径，清理shell配置文件中旧export语句，并执行go clean -cache和go clean -modcache清除缓存。
检查 GOPATH 和 GOROOT 是否残留旧配置
Go 1.16+ 默认启用 GO111MODULE=on，不再依赖 GOPATH 存放源码，但旧项目或手动安装的工具（如 gopls、dlv）可能仍写入 $GOPATH/bin。若你已迁移到模块模式，GOPATH 仅用于缓存和工具安装，不是必须清空，但需确认它不干扰当前开发。
常见错误现象：执行 go install 后命令在终端找不到，或 which go 指向旧版本 —— 很可能是 GOROOT 或 PATH 中残留了老 Go 安装路径（比如 /usr/local/go-old 或 ~/go1.15）。
- 运行
go env GOROOT和go env GOPATH，核对输出是否指向你当前期望的安装位置 - 检查
PATH：运行echo $PATH | tr ':' '\n' | grep -E '(go|Go|goroot|gopath)'，确认没有重复或过期路径 - 若发现冗余路径，从 shell 配置文件（
~/.zshrc、~/.bash_profile）中删掉对应export GOROOT=...或PATH=.../old-go/bin行
清理残留的 go toolchain 缓存和构建产物
go build 和 go test 会在 $GOCACHE（默认 $HOME/Library/Caches/go-build macOS / $HOME/.cache/go-build Linux）中缓存编译对象；go mod download 则把依赖存进 $GOPATH/pkg/mod。这些不是垃圾，但若你切换了 Go 版本或想排除缓存干扰测试，就得主动清理。
注意：go clean -cache 只清 $GOCACHE，不碰模块缓存；go clean -modcache 才删 pkg/mod —— 两者常被混淆。
- 清构建缓存：
go clean -cache - 清模块缓存：
go clean -modcache（会重新下载所有依赖，慎用于 CI） - 清本地测试覆盖文件：
go clean -testcache，避免旧go test -cover结果误用 - 若想彻底重来，可手动
rm -rf $GOPATH/pkg/mod/cache和$GOCACHE目录（比命令更彻底，尤其当go clean报错时）
验证 go install 工具链是否干净
Go 工具链（go 命令本身）不依赖用户目录，但通过 go install 安装的二进制（如 gopls@latest、stringer）会落在 $GOPATH/bin 或 $GOBIN。多个 Go 版本共存时，容易出现工具版本错配：比如用 Go 1.21 编译的 gopls 被 Go 1.22 运行时报 symbol not found。
典型错误现象：gopls 启动失败、VS Code 显示 “language server crashed”，或 go list -m all 报错提示 module 不兼容。
- 列出已安装工具：
ls $GOPATH/bin或ls $(go env GOPATH)/bin - 逐个检查版本：
gopls version、go version、dlv version，确认与当前go version匹配 - 重装关键工具：
go install golang.org/x/tools/gopls@latest（注意用当前 Go 版本执行） - 删掉明显过时的二进制，例如带版本后缀的
stringer-v1.0.0或mockgen-1.6.0
检查是否遗留未关闭的后台进程或调试端口
Go 程序本身不会自动注册系统服务，但开发中常起 HTTP server（:8080）、pprof（:6060）、delve（:2345）等监听端口。环境搭建后若没正常退出，这些进程可能残留并占用端口，导致下次启动失败。
容易被忽略的是：IDE（如 VS Code）调试会话断开后，delve server 有时没 kill 掉；或者 go run main.go 被 Ctrl+C 中断，但 goroutine 未响应信号继续跑。
- 查监听端口：
lsof -i :8080（macOS/Linux）或netstat -ano | findstr :8080（Windows） - 杀掉残留进程：
kill -9 $(lsof -t -i :6060)（谨慎使用-9，优先试kill） - 检查是否有孤儿 goroutine：启动程序时加
-gcflags="-l"禁用内联，再用pprof抓/debug/pprof/goroutine?debug=2看是否卡在 channel receive - 若用
dlv调试，确保退出时执行dlv exit或关掉调试会话，而非直接关终端
$GOCACHE 里一个损坏的 object 文件会让 go build 随机失败；又比如 pprof 端口被占，却只在 CI 里暴露。每次换 Go 版本或重装 IDE 插件后，花两分钟按这四步扫一遍，比出问题再 debug 快得多。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
