Go 1.21+ 不再强制要求 GOROOT 和 GOPATH，但需确保 go 命令在 PATH 中、GOROOT 指向正确安装路径、go.mod 存在且位置准确，否则 go run 或 go mod init 会因模块上下文缺失而报错。
Go 1.21+ 版本已不再支持 GOROOT 手动设置（除非你刻意覆盖默认路径），也不再需要把 go 命令加到 $PATH —— 安装包会自动完成。但新手常卡在「go run 报错：command not found」或「go mod init 失败：no Go files in current directory」，本质不是环境没装好，而是工作区和模块初始化逻辑没对上。
怎么确认 Go 真的装好了？别只看 go version
运行 go version 成功只说明二进制在 $PATH，不代表开发环境就绪。真正要检查的是：
-
go env GOROOT：应指向安装目录（如/usr/local/go或C:\Program Files\Go），不是你自己的项目目录 -
go env GOPATH：Go 1.16+ 默认使用$HOME/go（macOS/Linux）或%USERPROFILE%\go（Windows），它只影响go get下载的包存放位置，**不影响日常开发** -
go env GOBIN：空值是正常的；如果设了，确保该路径也在$PATH里，否则go install的命令找不到
常见误操作：手动把 GOROOT 指向项目文件夹，导致后续所有命令报 cannot find module root。
go mod init 必须在空目录里执行？错
go mod init 只要求当前目录**没有已有 go.mod 文件**，跟是否为空无关。但它会扫描当前目录下所有 .go 文件，并尝试推导模块路径（module path）。所以：
立即学习“go语言免费学习笔记（深入）”；
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
- 如果目录里已有
main.go，直接运行go mod init example.com/hello即可，不需要先清空 - 模块路径不必是真实域名；本地开发用
hello或myapp完全合法，只是发布时需改 - 如果运行后
go.mod里出现require行但没内容，说明没检测到任何依赖——这是正常现象，不是失败
容易踩坑：在父目录（比如 ~/projects）下误执行 go mod init，结果整个目录树被当成一个模块，后续新建项目会冲突。
为什么 go run main.go 总提示 “no required module”？
这个错误只发生在两种情况：
- 当前目录没有
go.mod文件，且 Go 版本 ≥ 1.16（默认启用 module-aware 模式） - 有
go.mod，但里面module声明的路径与当前文件实际路径不匹配（比如module example.com/a，但你在~/b/目录下运行）
解决方法很简单：
- 先确保已在项目根目录（含
main.go的那个目录）执行过go mod init xxx - 如果只是临时跑单文件，用
go run .（注意是英文句点）比go run main.go更可靠，它会主动加载当前模块上下文 - 不想用模块？加
-mod=mod参数强制启用模块模式，或临时设GO111MODULE=off（不推荐，仅调试用）
真正麻烦的是混合使用 vendor 和 go.work，新手请彻底忽略这两者，直到你遇到多人协作或跨模块复用场景。
最易被忽略的一点：Go 不像 Node.js 那样靠 package.json 识别项目根，它只认 go.mod 文件存在与否。删掉它，整个目录就“失联”了；放错位置，go 命令就会在错误的作用域里找依赖。
