直接换源比配代理更优先，Go二进制安装包应优先从阿里云镜像站手动下载，再配置GOPROXY=https://goproxy.cn,direct加速模块拉取，并对含破折号的版本号加引号。
直接换源比配代理更优先——Go 二进制安装包下载慢，90% 是卡在官网直连失败，必须先用国内镜像站手动下载安装包，再配 GOPROXY 加速模块拉取。
手动下载 Go 安装包时该选哪个镜像站
阿里云镜像（https://mirrors.aliyun.com/golang/）目前最稳，目录结构与官方完全一致，支持所有版本和架构（如 go1.23.5.linux-amd64.tar.gz），且 CDN 节点多、无访问频率限制。清华源（https://mirrors.tuna.tsinghua.edu.cn/golang/）次之，适合 macOS 用户；七牛云的 https://golang.google.cn/dl/ 是官方中国站，但偶尔同步延迟。
不要用 goproxy.cn 下载安装包——它是模块代理，不是二进制包镜像，访问会 404。
- Windows 用户下载
.msi或.zip，解压后手动配置GOROOT和PATH - macOS 用户优先选
.pkg安装包，双击安装后检查go version是否输出正常 - Linux 用户推荐
.tar.gz解压到/usr/local/go，避免权限冲突
GOPROXY 必须带 ,direct 才能用私有模块
只设 GOPROXY=https://goproxy.cn 看似能加速公开模块，但会导致公司内网 Git（如 git.internal.company/project）彻底无法拉取——代理把所有请求都拦了，连认证都不发出去。
立即学习“go语言免费学习笔记（深入）”；
,direct 不是可选项，是 fallback 机制必需部分：它表示当代理返回 404 或超时，Go 工具链自动回源直连原始仓库。
- 正确写法：
go env -w GOPROXY=https://goproxy.cn,direct - 多个镜像可用逗号拼接，但没必要堆砌：
https://goproxy.cn,https://mirrors.aliyun.com/goproxy/,direct - 若私有域名需跳过代理（如不走代理但又不希望校验失败），加
GONOPROXY=git.internal.company
go install 时版本号含破折号必须加引号
像 v2.0.0-alpha、v1.15.0-rc1 这类带破折号的 tag，shell 会把它当参数解析，导致 go install 报错或装错版本。
Go 1.21+ 默认启用模块感知安装，但命令行解析仍受 shell 影响，不加引号就等同于执行 go install github.com/xxx/yyy@v2.0.0 -alpha——后面那段被当成了独立参数。
- 正确写法：
go install "github.com/swaggo/swag/cmd/swag@v1.15.0-rc1" - 查可用版本：
go list -m -versions github.com/swaggo/swag - 装完记得确认
GOBIN在$PATH里，否则提示command not found
checksum mismatch 别急着关校验
报 verifying github.com/xxx@vX.Y.Z: checksum mismatch，大概率是本地 go.sum 缓存污染或镜像同步滞后，不是网络问题。
全局设 GOINSECURE 或 -insecure 会绕过所有校验，存在依赖投毒风险；临时方案应更精准。
- 先清缓存：
go clean -modcache，再重试go get - 仅对当前命令禁用校验：
go get -insecure github.com/xxx/yyy - 若用
replace指向本地路径，务必删掉// indirect标记，否则go mod verify会误算校验值
真正容易被忽略的是：direct 尾缀和引号包裹版本号——前者让私有模块可用，后者让预发布版本不翻车，两者都踩中就等于环境搭了一半却跑不通。
