go项目跑不起来主因是环境配置冲突：需确保which go与go env goroot一致、清除残留gopath/goroot导出、强制go env -w go111module=on、设gobin并加入path，且修改后必须source或重启终端生效。
Go 项目跑不起来，八成不是代码问题，而是环境没对——GOPATH 已废弃但残留配置还在捣乱，GO111MODULE 默认值在不同 Go 版本间反复横跳，go install 装的二进制找不到路径……这些不是“玄学”，是可复现、可清除的配置冲突。
确认 Go 安装是否干净（别信 go version 就万事大吉）
只运行 go version 成功，不代表环境可用。常见假成功场景：系统 PATH 里混着旧版 Go 的 bin 目录，或者 shell 配置文件里硬编码了过时的 GOROOT。
- 执行
which go和go env GOROOT，两者输出必须一致且指向你刚安装的目录（如/usr/local/go） - 检查
go env GOPATH—— Go 1.16+ 新项目应为空或仅用于存放非模块化工具，若返回/home/user/go且你没主动设过，说明有残留 shell 配置（比如~/.bashrc里还写着export GOPATH=...） - 删掉所有手动写的
GOPATH、GOROOT导出语句，重启终端，再跑go env看是否回归默认行为
GO111MODULE 到底该开还是关
它控制 Go 是否强制使用模块（go.mod），但默认值随 Go 版本变：1.12–1.15 默认 auto（在 GOPATH 外自动启用），1.16+ 默认 on。混乱就来自这个“auto”。
- 永远显式设置：
go env -w GO111MODULE=on—— 新项目必须用模块，老项目迁移到模块也比维护GOPATH省心 - 如果遇到
cannot find module providing package xxx，先确认当前目录下有go.mod；没有就运行go mod init your-module-name（名字要能反映实际导入路径，比如github.com/you/project） - 别信 IDE 自带的 Go SDK 检测——有些会绕过 shell 环境变量，直接读系统 PATH，导致 IDE 里能跑、终端里报错
go install 装的命令为什么 command not found
Go 1.17+ 改变了 go install 行为：它不再把二进制放 $GOPATH/bin，而是放 $GOCACHE/bin（通常为 ~/Library/Caches/go-build 或 ~/.cache/go-build），而这个路径不在系统 PATH 中。
- 运行
go env GOBIN，如果为空，说明 Go 正在用默认缓存 bin 目录；此时需手动加路径到PATH，例如：export PATH=$PATH:$(go env GOCACHE)/bin - 更简单的办法：设一个固定
GOBIN，比如go env -w GOBIN=$HOME/go/bin，然后确保$HOME/go/bin在PATH中 - 验证方式：运行
go install golang.org/x/tools/cmd/goimports@latest后，立刻执行goimports -v，不报错才算真正可用
最常被忽略的一点：Go 环境变量是分 shell 会话生效的，改完 ~/.zshrc 后没 source，或开了新终端却忘了重新登录，就会卡在“明明设了却不起作用”的死循环里。动手前，先 echo $PATH 和 go env 对两遍。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
