go version能运行但go mod tidy卡住或报错，说明Go已安装成功，问题出在GOPROXY未配置或配置错误；国内必须设为如https://goproxy.cn,direct，且direct须置于末尾作为兜底直连机制。
go version 能跑，但 go mod tidy 卡住或报错
说明 Go 二进制已装好，但模块代理没配或配错。国内直连 proxy.golang.org 几乎必然超时或返回 404，go mod tidy 会卡在 “downloading” 或直接报 reading ...: unexpected EOF、no matching versions for query "latest"。
必须显式配置 GOPROXY，且不能只写一个地址：
go env -w GOPROXY=https://goproxy.cn,https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct-
direct必须放在最后——它不是备用代理，而是“所有代理都失败后直连原始模块服务器（如 github.com）”的兜底机制 - 如果只写
https://goproxy.cn，遇到 404 就退出，不会 fallback 到direct - 验证是否生效：
go env GOPROXY输出应与你设置的一致
Windows 安装后 go 命令找不到或版本不对
常见于 .msi 安装后没重启终端，或手动解压 .zip 包但没配环境变量。
关键动作只有两个：
立即学习“go语言免费学习笔记（深入）”；
- 关闭所有已打开的 CMD / PowerShell 窗口，再重新打开——否则系统环境变量不刷新
- 运行
go version，输出必须是类似go version go1.25.0 windows/amd64；若报“不是内部或外部命令”，说明PATH没包含 Go 的bin目录（默认为C:\Program Files\Go\bin） - 不要用系统包管理器（如 Chocolatey 的
choco install golang）——它常装旧版，且GOROOT可能被硬编码，导致后续go build找不到fmt等标准库
Linux/macOS 下 GOPATH 和 GOROOT 怎么设才不冲突
GOROOT 是 Go 安装根目录，GOPATH 是你放项目的个人工作区，二者绝不能相同。
错误做法：把 GOPATH 设成 /usr/local/go（和 GOROOT 一样），会导致 go install 尝试往 GOROOT/bin 写文件，触发权限拒绝或污染工具链。
正确路径示例：
-
GOROOT=/usr/local/go（解压后的实际路径，无软链接、无尾斜杠） -
GOPATH=$HOME/go（推荐，自动创建$HOME/go/{bin,pkg,src}） - 写入
~/.zshrc或~/.bashrc，顺序不能错：export GOROOT=/usr/local/go→export GOPATH=$HOME/go→export PATH=$GOROOT/bin:$GOPATH/bin:$PATH - 验证：
go env GOROOT和go env GOPATH应分别输出上述绝对路径
引用公司私有 Git 仓库时依赖拉不下来
即使 GOPROXY 配了，私有域名（如 git.internal.company.com）仍会被代理转发，结果 404 或泄露凭证。
必须加两行配合：
-
go env -w GOPRIVATE=git.internal.company.com/*—— 让 Go 跳过代理，直连该域名 -
go env -w GOINSECURE=git.internal.company.com—— 若用自签名证书，跳过 TLS 校验，否则报x509: certificate signed by unknown authority - 多个域名用逗号分隔：
GOPRIVATE=git.internal.company.com/*,github.com/my-org/private-repo - 改完后执行
go clean -modcache清掉旧缓存，再go mod tidy重试
direct，私有模块域名漏加 GOPRIVATE 会导致静默失败，而 IDE（如 GoLand）有时会缓存旧的 GOPROXY 值，需要重启或手动刷新模块索引。 
