go version不识别或显示旧版本，说明系统path未正确配置go二进制路径；需检查windows的path环境变量或macos/linux的shell配置文件（如~/.zshrc），确保包含go安装目录的bin路径，并在新终端中验证which go和go version输出。
go version 命令不识别或显示旧版本
说明：这不是 Go 没装好，而是系统根本找不到 go 二进制，或 PATH 里混进了旧版本残留。
- Windows 用户检查系统环境变量
Path是否包含C:\Go\bin（默认安装路径）；若手动解压到其他位置（如D:\go\bin），必须填入实际路径 - macOS/Linux 用户确认 shell 配置文件（
~/.zshrc或~/.bash_profile）中写了export PATH=$PATH:/usr/local/go/bin，且执行过source ~/.zshrc - 曾用
brew install go装过旧版？先运行brew uninstall go，再删掉/usr/local/bin/go这类残留文件 - 验证方式：新开终端窗口，运行
which go—— 输出应为有效路径；再跑go version，应显示官网下载的最新稳定版（当前是go1.22.5）
go mod init 报 “no required module provides package”
这是模块模式启用后最典型的提示，不是错误，是 Go 在告诉你：“我不知道这个代码属于哪个项目”。
Golang Samber Hot
下载
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
- 在
hello.go所在目录下，先执行go mod init example.com/hello（模块名可任意，不用对应真实域名） - 执行后生成
go.mod文件，内容只有一行：module example.com/hello - 之后再运行
go run hello.go就能通过——哪怕文件里只有一行fmt.Println("ok") - 切勿在
$GOPATH/src下新建项目，那是 GOPATH 模式的老习惯，现在反而触发缓存冲突
国内拉依赖卡死、超时或 connection refused
本质是没配代理，go get 或 go mod tidy 默认直连 golang.org，国内无法访问。
- 立即执行：
go env -w GOPROXY=https://goproxy.cn,direct（,direct表示私有仓库跳过代理） - 验证是否生效：
go env GOPROXY应输出你刚设的地址 - 如果项目已有
go.mod，建议再跑一次go mod download清空缓存重拉 - 别信“不用配代理也能行”的旧教程——2026 年国内网络环境下，不配基本寸步难行
go run main.go 提示 “package main is not a main package”
这不是环境问题，是代码结构硬性不满足 Go 的可执行要求。
- 检查文件第一行是否为
package main（不能是package hello，也不能漏掉） - 检查是否有且仅有一个
func main()，签名必须完整：不能带参数、不能有返回值、不能拼成Func Main() - 如果目录下有多个
.go文件，确保所有文件都声明为package main；混入package utils会直接失败 - Windows 用户慎用记事本保存：可能插入 BOM 头，导致解析失败；改用 VS Code 并选“UTF-8 无 BOM”格式保存
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
