linux 下应下载官方 go 二进制包（如 go1.23.3.linux-amd64.tar.gz）解压至 /usr/local/go，严格设置 goroot=/usr/local/go（无尾斜杠、非软链接），path 中 $goroot/bin 需优先于 $gopath/bin；goproxy 应设为多镜像 fallback 形式（如 https://goproxy.cn,https://mirrors.aliyun.com/goproxy/,direct），私有域名需通过 gonoproxy 显式排除；go install 必须指定精确版本号，避免使用 @latest；gobin 需加入 path；编译时建议启用 gocache 并合理设置 -p 并行数与 -mod=readonly 模式。
不装系统包管理器提供的 Go
Linux 上用 apt install golang 或 yum install golang 装出来的 Go，大概率不是你想要的版本。它通常滞后 2～4 个小版本，GOROOT 被硬编码在 /usr/lib/golang 这类路径里，go env -w GOROOT 无效，后续 go build 会报 cannot find package "fmt" —— 因为标准库根本没被正确识别。
更麻烦的是 ARM64 服务器上直接报 cannot execute binary file: Exec format error，因为系统包里的二进制未必适配你的架构。
- 下载官方
.tar.gz包（如go1.23.3.linux-amd64.tar.gz），解压到/usr/local/go -
GOROOT必须指向这个解压目录，不能是软链接，也不能带尾部斜杠 -
PATH中$GOROOT/bin要排在$GOPATH/bin前面，否则可能调用错版本
GOPROXY 必须设成多镜像 fallback 形式
只设 GOPROXY=https://goproxy.cn 是不够的。它不代理私有域名（比如 git.internal.company），也不处理 replace 或 exclude 场景，一旦镜像同步延迟或临时不可用，go mod tidy 就卡住不动。
正确写法是逗号分隔多个地址加 direct：
export GOPROXY=https://goproxy.cn,https://mirrors.aliyun.com/goproxy/,direct
direct 表示兜底直连，不是“跳过代理”，而是当所有镜像都失败时才触发；它不会绕过 checksum 校验，也不会泄露私有模块请求。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 验证是否生效：
go env GOPROXY输出应含goproxy.cn，再跑go list -m github.com/spf13/cobra@latest，响应应在毫秒级 - 私有仓库必须显式排除：
go env -w GONOPROXY=git.internal.company，否则认证失败或请求被拦截 - 别用
GOINSECURE全局关校验，它影响所有匹配域名，风险高；真要绕过，仅限单次命令加-insecure
go install 必须带精确版本号
执行 go install github.com/swaggo/swag/cmd/swag@latest 很危险：它可能拉到未发布的 master 分支，导致生成文档失败或 CLI 命令 panic。Go 1.21+ 默认启用模块感知安装，但 @latest 不等于“最新稳定版”，而是“最新 tag 或 commit”。
正确流程是先查可用版本，再锁定安装：
go list -m -versions github.com/swaggo/swag<br>go install github.com/swaggo/swag/cmd/swag@v1.8.10
- 含破折号的版本（如
v2.0.0-alpha）必须用双引号包裹：go install "github.com/xxx/yyy@v2.0.0-alpha" -
GOBIN必须加入PATH，否则swag命令找不到；go env GOBIN可确认路径 - 不要在
go.mod里手动加replace指向本地路径后还留着// indirect标记，这会导致 checksum 计算异常
编译加速依赖缓存与并行控制
Go 编译快是默认行为，但大型项目里慢下来，往往不是语言本身问题，而是缓存没起作用或并行策略不合理。
GOCACHE 默认开启，路径通常是 $HOME/Library/Caches/GoBuild（macOS）或 $HOME/.cache/go-build（Linux）。如果 CI 流水线每次清空工作区却不保留 GOCACHE，就等于放弃增量编译能力。
- 检查缓存是否生效：
go env GOCACHE，非空即启用；go clean -cache仅调试时用 -
go build -p 4显式指定并行数（-p等价于-parallel），避免默认值在高核机器上调度失衡 -
go build -mod=readonly防止意外修改go.mod，尤其在 CI 中能避免因权限或网络波动导致构建失败 - 频繁改
main.go时，别go build ./...，只构建目标子命令：go build ./cmd/myapp
真正容易被忽略的是 go mod download 的离线预热能力——它不触发构建，只拉依赖进 $GOMODCACHE，适合无外网权限的生产环境或 CI 镜像预构建阶段。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
