内网执行go mod download卡住或报connection refused，是因默认代理proxy.golang.org不可达；应禁用代理设goproxy=direct，或部署athens/goproxy.cn离线镜像，并同步设gosumdb=off或指向内网校验服务。
内网机器执行 go mod download 卡住或报错 connection refused 怎么办
这不是 Go 安装失败，而是模块代理不可达导致的——Go 1.13+ 默认走 proxy.golang.org，内网直连必然超时或拒绝连接。
- 临时应急：运行
go env -w GOPROXY=direct，让 Go 直接从源码仓库拉取；但仅适用于已预置vendor/或内网有私有 Git（如 Gitee、GitLab）且地址已写死在go.mod中的场景 - 真正可用的方案是部署离线代理服务：用
athens或goproxy.cn的离线镜像版，在内网某台能出网的机器上跑goproxy（Go 实现），再通过内网 IP 暴露端口（如http://192.168.1.100:8080），然后设go env -w GOPROXY=http://192.168.1.100:8080 - 必须同步处理校验和：否则
go build仍会尝试访问sum.golang.org。要么关掉校验go env -w GOSUMDB=off，要么部署内网sum.golang.org镜像并指向它
go install 写入到错误目录或找不到命令怎么办
常见原因是 GOROOT 和 PATH 不匹配，尤其在离线解压安装后容易忽略路径权限和生效范围。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 解压
go1.xx.x.linux-amd64.tar.gz后，把bin/go所在目录（如/opt/go/bin）加入PATH；建议写入/etc/profile.d/golang.sh（对所有用户生效），而不是仅改当前 shell 的~/.bashrc - 显式设置
GOROOT：运行go env -w GOROOT=/opt/go，避免多版本共存时 IDE 或 CI 工具读取失败；不设的话 Go 会自动推导，但go install可能写进错误的bin目录 - 验证两件事：
go version能否执行，以及go env GOROOT输出是否与实际解压路径一致。例如解压到了/usr/local/go却没设GOROOT，go install就可能把二进制写进/root/go/bin而非预期位置
跨平台编译产出可直接运行的二进制，为什么本地测试正常、目标机器却报 not a valid ELF executable
本质是 GOOS/GOARCH 设定与目标系统不匹配，或 CGO 混入了宿主机动态链接依赖。
- 禁用 CGO 是最稳妥的做法：
CGO_ENABLED=0 go build -o myapp-linux-amd64。一旦启用 CGO，编译产物就依赖目标机器上的 libc 版本，而内网服务器往往系统老旧 - 确认目标平台真实架构：Linux 下用
uname -m看是x86_64还是aarch64；Windows 下注意区分amd64和arm64；不要凭经验硬猜 - 交叉编译前清空缓存：
go clean -cache -modcache，避免旧构建残留影响新产物；尤其是从 macOS 编译 Linux 二进制时，$HOME/Library/Caches/go-build里可能混入 darwin 目标对象
离线环境如何确保 go build 不依赖网络
关键不在 Go 本身（它自带标准库），而在依赖管理是否真正“断开”了远程通道。
- 提前在有网机器完成完整依赖拉取：
go mod download→go mod vendor，再把整个vendor/目录打包带走；离线机器上必须保证go.mod里没有// indirect标记但未出现在vendor/modules.txt中的模块 - 验证 vendor 完整性：在离线机运行
go list -m all（需先GO111MODULE=on），比对输出是否全部被vendor/覆盖；缺失项会导致构建时仍尝试联网 - 关闭模块代理和校验和检查：设
GOPROXY=direct和GOSUMDB=off，否则哪怕有vendor/，Go 仍可能发起 HEAD 请求校验模块存在性
go build 仍会悄悄连外网查签名。关掉 GOSUMDB 或配好内网校验服务，才是离线真正闭环的最后一环。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
