缺CA证书导致go mod download失败，需在Dockerfile中安装ca-certificates（Debian用apt-get，Alpine用apk add），而非绕过校验；同时必须安装git和dlv等基础工具链，否则go get、调试等功能均会中断。
Go命令能运行但go mod download失败，基本就是依赖缺失，不是网络问题，而是容器、系统或配置层面缺了关键组件。
go mod download 报错“x509: certificate signed by unknown authority”
这是最典型的“依赖缺失”假象——实际缺的是 CA 证书，不是 Go 包。官方镜像（如 golang:1.22-slim）精简掉了 ca-certificates，导致 HTTPS 请求直接被 TLS 层拒绝。
- Debian/Ubuntu 基础镜像：在
Dockerfile中加apt-get update && apt-get install -y ca-certificates - Alpine 镜像：用
apk add --no-cache ca-certificates，别漏掉--no-cache - 本地 macOS/Linux：确认系统证书库已更新，macOS 可运行
sudo security unlock-keychain login.keychain-db后重试 - 不建议绕过：设
GOSUMDB=off或GOINSECURE只是掩耳盗铃，无法解决根本问题
go get 或 go install 工具时提示 “command not found: git”
go get（虽已弃用但大量脚本仍在用）和 go mod download 拉私有仓库、解析 replace 路径、甚至 gopls 初始化都隐式依赖 git。官方镜像默认不带 git，裸跑必卡住。
- 必须显式安装：
apt-get install -y git（Debian）或apk add --no-cache git（Alpine） - 验证是否生效：进容器执行
git --version，不能只看go version - Windows WSL2 用户注意：若宿主机没装 Git，Docker Desktop 的 WSL2 后端可能无法透传，需在 WSL2 内单独装 Git
- 别用
go env -w GOPROXY=direct来“规避”，这会让私有模块彻底不可拉取
VS Code 调试失败，dlv 启动报 “exec: ‘dlv’: executable file not found”
这不是路径问题，是 dlv 根本没装。官方镜像不包含 Delve，而 VS Code 的 Go 扩展又不会自动帮你装——它只检查是否存在，不存在就报错。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 必须用
go install安装：go install github.com/go-delve/delve/cmd/dlv@latest - 确保
GOBIN在PATH中，且与go env GOBIN输出一致 - 顺序很重要：先装
dlv，再装gopls；否则gopls启动时找不到dlv路径会静默降级 - 别用
apt install delve：包管理器装的版本常滞后，且二进制名/路径可能不兼容 VS Code 插件约定
多用户服务器上 go mod download 并发失败或缓存损坏
多人共用 NFS 挂载的 $HOME 时，$GOCACHE 和 $GOPATH/pkg/mod 是共享写入点，go mod download 的并发写入会导致索引损坏、checksum mismatch 等看似“网络错误”的现象。
- 每个用户必须显式设置独立缓存路径：
export GOCACHE=$HOME/.cache/go-build -
export GOPATH=$HOME/go也要明确，避免 fallback 到全局路径 - 禁用
go env -w：该命令写入的$HOME/go/env是纯文本，无权限控制，易被误覆盖 - CI/CD 或定时任务中，务必用 login shell（如
bash -l -c "go mod download"）加载完整环境，否则GOPATH可能为空
真正麻烦的从来不是“少装了一个包”，而是多个缺失组件叠加后，错误信息指向性极差——比如 gopls 启动失败，可能是缺 git、缺 dlv、缺 ca-certificates，甚至只是 GOBIN 不在 PATH。排查时优先验证基础工具链是否存在，再看 Go 自身行为，别一上来就调代理或关校验。
