直接配置goproxy和gosumdb能解决90%依赖问题：需先确认go≥1.11、go111module=on，再设goproxy="https://goproxy.cn|https://mirrors.aliyun.com/goproxy|direct"和gosumdb=off，最后清理缓存并验证闭环流程。
直接配置 GOPROXY 和 GOSUMDB 就能解决 90% 的依赖下载失败、超时、校验失败问题，不用改源码、不装代理服务、不碰 go env 以外的任何东西。
确认 Go 版本并强制启用 Module 模式
新开发板上常因旧系统预装低版本 Go（如 1.10 或更低）导致 go mod 不生效。必须先验证并确保最低版本为 1.11，且 Module 强制开启：
- 运行
go version，若输出低于go1.11，立刻从 go.dev/dl 下载最新.tar.gz包手动安装（Linux 常见路径：/usr/local/go） - 执行
go env -w GO111MODULE=on—— 不要用auto，避免在非 GOPATH 路径下意外失效 - 检查
go env GOMOD是否返回项目根目录下的go.mod路径；若为空，说明未识别模块，需先go mod init example.com/foo
设置国内镜像代理链（含 fallback 机制）
单点代理（如只设 goproxy.cn）在开发板网络波动时容易卡死。Go 1.15+ 支持竖线分隔的代理列表，会按序尝试直到成功，这是最稳的写法：
- 执行：
go env -w GOPROXY="https://goproxy.cn|https://mirrors.aliyun.com/goproxy|direct" -
direct必须保留，否则私有仓库或本地replace会被拦截 - 不要用
http://开头的地址（如旧文档里的http://goproxy.io），Go 默认拒绝非 HTTPS 代理 - 验证是否生效：运行
go list -m github.com/golang/freetype@v0.0.0-20170609003507-e23772dcdcdf，看是否秒出结果而非卡住
关闭 GOSUMDB 校验（仅限离线/内网开发板）
开发板若无公网访问能力（比如只有局域网），GOSUMDB=sum.golang.org 会导致 go get 直接失败，错误信息通常是 failed to fetch 或 no matching hashes：
- 执行：
go env -w GOSUMDB=off—— 这是最简单可靠的绕过方式 - 若需保留校验但又无法连外网，可设为私有 sumdb（极少见），或改用
GOSUMDB=sum.golang.google.cn（国内可用，但开发板上仍大概率不可达） - 注意：
GOSUMDB=off仅影响校验环节，不影响依赖下载本身；只要GOPROXY配对正确，go.mod和go.sum仍会正常生成和更新
清理缓存并验证最小闭环流程
开发板首次配置后，旧缓存可能残留干扰，必须清掉再走一遍最小验证流：
- 执行：
go clean -modcache（清除所有已下载模块） - 新建测试目录：
mkdir /tmp/testmod && cd /tmp/testmod - 初始化：
go mod init testmod - 拉一个轻量依赖：
go get github.com/google/uuid@v1.3.0 - 检查：
ls -la ./go.*应看到go.mod和go.sum已生成，且go list -m all | grep uuid能输出对应版本
真正容易被忽略的是：开发板上 shell（如 busybox ash）可能不支持 go env -w 的写入，此时需手动编辑 $HOME/go/env 文件（若存在）或在启动脚本中用 export GOPROXY=...；另外，某些嵌入式 Linux 的 /tmp 是内存文件系统，重启即丢，go env -w 写入的配置可能失效，务必加到 /etc/profile 或用户 shell 配置中。
