go version和go env验证失败说明path未生效，windows需重启cmd/powershell，macos/linux需source shell配置文件，并确认goroot/bin已加入path。
go version 和 go env 验证失败，说明环境变量没生效
安装完 go 后执行 go version 报错 'go' 不是内部或外部命令（Windows）或 command not found: go（macOS/Linux），基本就是 PATH 没配对。关键不是“有没有配”，而是“配完有没有重新加载终端”。
- Windows 用户装的是
.msi包，安装程序会自动写入系统 PATH，但必须关闭并**重新打开所有 CMD/PowerShell 窗口**——旧窗口的环境变量不会自动刷新 - macOS/Linux 用户如果手动编辑了
~/.zshrc或~/.bashrc，一定要运行source ~/.zshrc（注意 shell 类型）；用 VS Code 终端时，它可能不读取 shell 配置，建议直接用系统 Terminal 测试 - 检查
GOROOT是否指向安装目录（如C:\Program Files\Go或/usr/local/go），PATH里是否包含$GOROOT/bin——漏掉这个路径就找不到go命令
go mod init 初始化失败：no module found
在空目录下执行 go mod init example.com/hello 却报错 go: cannot find main module 或提示“outside of GOPATH”，说明当前目录不在模块感知范围内，或者项目结构不符合 Go Modules 要求。
Golang Samber Hot
下载
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
- 确保你是在**项目根目录**下运行
go mod init，且该目录下已有main.go（或至少一个.go文件），否则go工具无法识别为有效模块 - 不需要预先创建
GOPATH/src目录结构 —— Go 1.13+ 默认启用 Modules，GOPATH只影响go install的输出位置，跟模块初始化无关 - 如果目录里有老的
vendor/或go.sum，先清理再 init；若之前用过GO111MODULE=off，执行go env -w GO111MODULE=on强制开启
go build 编译出错：missing required module
执行 go build 时提示 go: finding module for package xxx 然后失败，常见于引入第三方包（比如 github.com/gin-gonic/gin）但没下载依赖。
-
go build默认不会自动拉取远程模块 —— 它只编译，不管理依赖。正确做法是先运行go mod tidy，它会解析 import、下载缺失模块、更新go.mod和go.sum - 国内用户必须配置代理，否则
go mod tidy极易超时。确认已执行：go env -w GOPROXY=https://goproxy.cn,direct - 如果用了私有仓库（如公司内网 Git），需额外配置
go env -w GOPRIVATE=git.internal.company.com，否则 proxy 会跳过认证请求
交叉编译生成 Linux 或 macOS 二进制失败
在 Windows 上执行 GOOS=linux GOARCH=amd64 go build -o app-linux 却生成了 Windows 可执行文件，或报错 exec format error，问题出在环境变量作用域和构建约束上。
- Windows CMD 不支持
GOOS=xxx go build这种写法，必须分两步：set GOOS=linux && set GOARCH=amd64 && go build -o app-linux；PowerShell 用$env:GOOS="linux" - macOS 上编译 Windows 版本（
GOOS=windows）默认生成.exe，但若源码里用了// +build windows约束，而其他平台代码没加对应约束，会导致部分文件被忽略 - 交叉编译不能替代真实平台测试 —— 比如 cgo 依赖的本地库（如 SQLite）在跨平台时大概率失效，这类场景应优先用 Docker 构建
go mod tidy 和 GOPROXY 的配合时机：很多人先写代码、再 init、再 build，结果 build 失败才想起拉依赖，但此时 go.mod 里可能已漏写某些间接依赖。养成习惯：每次新增 import 后，立刻跑一遍 go mod tidy。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
