go命令未识别的根本原因是path未正确配置，windows需检查安装时“add go to path”是否生效或手动添加c:\go\bin，macos/linux需确认/usr/local/go/bin已加入shell配置并重载，且仅添加goroot/bin而非混入gopath。
go version 无输出或报 command not found
说明系统根本没识别到 go 命令，不是版本问题，是路径没配对。Windows 用户常见于安装时勾选了“Add Go to PATH”但实际没生效；macOS/Linux 用户则多因 PATH 没写对或 shell 配置文件没 reload。
- 先确认安装是否真的完成：检查
C:\Go\bin（Windows）、/usr/local/go/bin（macOS/Linux）是否存在go可执行文件 - Windows 下打开新 PowerShell 或 CMD，别复用旧终端；macOS/Linux 执行
source ~/.zshrc（或~/.bash_profile）再试 - 别把
GOROOT和GOPATH混着写进PATH——只加$GOROOT/bin就够了，加多了反而可能冲突 - 如果用
gvm管理多版本，记得gvm use go1.24.4后再验证，否则go version仍显示系统默认版本
go run 和 go build 的行为差异
go run 是临时编译并立即执行，不生成可执行文件；go build 编译后生成二进制，但默认不运行。两者对 main 包的识别逻辑一致，但容错边界不同。
-
go run .要求当前目录下有且仅有一个main包，且所有.go文件都得属于该包；若混入测试文件（如xxx_test.go），会报package main is not a main package -
go build -o app生成的可执行文件默认放在当前目录，不会自动清理旧文件，重复构建时得手动删或加-a强制重编译 - 跨平台编译要设
GOOS和GOARCH：比如在 macOS 上编译 Windows 版本，得GOOS=windows GOARCH=amd64 go build -o app.exe，漏掉任一环境变量都会生成当前系统可执行文件 - 如果项目用了 Go Modules，
go run会自动下载依赖；但go build在 CI 环境里若没提前go mod download，可能因网络超时失败
go mod init 后 go get 报 proxy 错误
国内直接连 proxy.golang.org 会超时或拒绝连接，错误信息通常是 Get "https://proxy.golang.org/...": dial tcp: i/o timeout 或 403 Forbidden。
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或https://mirrors.cloud.tencent.com/go/，注意末尾的,direct不能少——它表示当代理无法命中时回退到直连 - 别用
export GOPROXY=...临时设置，因为go命令优先读取go env中的值，shell 环境变量会被忽略 - 如果公司内网有私有代理，需额外配置
GOPRIVATE：比如go env -w GOPRIVATE=git.example.com/internal，否则匹配到的模块仍走公共代理 - 改完后执行
go env GOPROXY确认生效，再跑go get；若仍有问题，加-v参数看具体卡在哪一步
go clean -modcache 清不干净或太慢
go clean -modcache 会删掉整个模块缓存目录（默认 $GOPATH/pkg/mod），但有时删完 go mod download 又卡住，或者发现磁盘空间没明显释放。
- 先查真实缓存路径：
go env GOMODCACHE，有些用户自定义过GOPATH，缓存位置就不是默认值 - 删之前建议
du -sh $(go env GOMODCACHE)看大小，百 MB 级别才值得清；几 GB 的话，清完重新go mod download可能比等它慢慢 resolve 还慢 - 如果只是想清理某一个模块，别用
-modcache，改用go clean -modcache后手动删$(go env GOMODCACHE)/github.com/some/project@v1.2.3 - CI 场景下更推荐
go mod download+go mod verify组合，而不是反复清缓存——缓存本质是优化手段，不是必须保持“干净”
GO111MODULE=on，哪怕不在 GOPATH 下，只要目录含 go.mod 就走 module 模式；但如果你在老项目里删了 go.mod 又没关 module，go get 会报错说找不到 go.mod，而不是安静地走 GOPATH 模式。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
