Go 1.21+ 要求 Linux 内核 ≥ 2.6.32、glibc ≥ 2.17，老旧发行版易因 GLIBC_2.17 缺失或架构不匹配报错；需用 uname -r 和 ldd --version 验证版本，推荐 Ubuntu 22.04 或 Debian 12，Go 1.22+ 应手动解压官方包至 /usr/local，PATH 与 GOPATH 需写入 ~/.profile 并 source 生效，国内环境须配置 GOPROXY，同时校准系统时间、禁用 IPv6 并检查 DNS。
确认虚拟机基础环境是否满足 Go 运行要求
Go 1.21+ 官方要求 Linux 内核 ≥ 2.6.32、glibc ≥ 2.17。老旧发行版（如 CentOS 6、Debian 8）常因 GLIBC_2.17 not found 或 cannot execute binary file: Exec format error 直接失败。
- 先运行
uname -r和ldd --version查内核与 C 库版本 - 推荐用 Ubuntu 22.04 LTS 或 Debian 12，自带新版 glibc，apt 源中
go-1.19足够启动项目 - 若需 Go 1.22+，跳过系统包管理器，直接下载官方
go1.22.5.linux-amd64.tar.gz解压到/usr/local - 运行
lscpu | grep "Architecture"确认是x86_64还是aarch64，选错架构包会报错
PATH 和 GOPATH 配置必须生效于所有终端类型
虚拟机图形界面里点“打开终端”常启动非登录 shell，~/.bashrc 不自动加载，导致 go 命令可用但 go run 找不到模块，go env GOPATH 返回空或默认值。
- 把
export PATH=$PATH:/usr/local/go/bin和export GOPATH=$HOME/go放进~/.profile（不是仅~/.bashrc），确保 GUI 终端也加载 - 执行
source ~/.profile后验证：which go应输出/usr/local/go/bin/go，go env GOPATH应显示/home/username/go - 不要设
GOPATH为/vagrant或 VirtualBox 共享文件夹路径——fsnotify在共享目录下常失效，引发go mod tidy反复卡住
国内虚拟机必须显式配置多源 GOPROXY
虚拟机默认无代理，go mod download 直连 proxy.golang.org 极易超时或返回 403；更隐蔽的是 NAT 模式下 DNS 缓存异常，ping proxy.golang.org 成功但 curl -v https://proxy.golang.org 卡在 TLS 握手。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 优先执行：
go env -w GOPROXY="https://goproxy.cn,direct"（国内推荐） - 避免单点故障：也可用
go env -w GOPROXY="https://proxy.golang.org,https://goproxy.io,direct" - 若虚拟机可走公司 HTTP 代理，填
http://proxy.internal:8080（注意是http://，部分代理不支持 HTTPS upstream） - 调试阶段可临时禁用校验：
go env -w GOSUMDB=off，否则 checksum 验证可能卡死
时间同步和 IPv6 是最容易被忽略的两个故障点
虚拟机系统时间比真实时间慢几分钟，会导致 TLS 握手失败，表现为 Get "https://goproxy.cn/": x509: certificate has expired or is not yet valid；VirtualBox 默认启用 IPv6，但多数国内 DNS 不响应 IPv6 查询，造成模块拉取卡顿。
立即学习“go语言免费学习笔记（深入）”；
- 强制同步时间：
sudo timedatectl set-ntp true，再检查timedatectl status中 “System clock synchronized” 是否为 yes - 禁用 IPv6：
echo 'net.ipv6.conf.all.disable_ipv6 = 1' | sudo tee -a /etc/sysctl.conf && sudo sysctl -p - 检查 DNS：
cat /etc/resolv.conf若指向127.0.0.1（如 systemd-resolved 干预），临时换为nameserver 223.5.5.5
