离线Go开发需在有网机器用目标Go版本执行go mod download预拉取依赖，并通过go mod vendor或离线GOPROXY实现完全离线构建，同时注意GOSUMDB=off、CGO_ENABLED适配及系统库和cgo依赖的完整性验证。
离线环境无法 go get，必须提前拉取所有依赖
Go 没有内置的“离线包管理器”，go get 默认走网络请求。一旦断网或受限（如内网、海关防火墙），go mod download 会直接失败，报错类似：proxy.golang.org: no such host 或 timeout。核心解法不是“绕过”，而是**在有网机器上完整预打包依赖**，再拷贝过去。
- 必须用与目标环境完全一致的 Go 版本（如
go1.21.6）执行下载，否则go.mod中的// indirect标记和校验和可能不兼容 - 运行
go mod download -x（加-x查看实际下载路径），确认所有模块都落盘到$GOPATH/pkg/mod/cache/download/ - 依赖包本身可能含
replace或require到私有 Git 地址，需一并 clone 并用go mod edit -replace改为本地路径（如./vendor/mylib）
用 go mod vendor + 离线 GOPROXY 打包最稳妥
go mod vendor 把所有依赖复制进项目根目录的 vendor/ 文件夹，之后编译全程不联网；但要注意它不包含 replace 的本地模块，也不处理 // indirect 的间接依赖——得先 go mod tidy 再 vendor。
- 执行顺序必须是：
go mod tidy→go mod vendor→ 检查vendor/modules.txt是否覆盖全部go.sum条目 - 若依赖中含 cgo 或汇编文件（如
net包调用系统 DNS），vendor后仍需目标机器安装对应 C 工具链（gcc、pkg-config） - 可搭配离线
GOPROXY：把$GOPATH/pkg/mod/cache/download/整个目录打包，用goproxy工具起一个本地代理（如goproxy -proxy=file:///path/to/cache），再在离线机设GOPROXY=http://localhost:8080
交叉编译时注意 CGO_ENABLED 和系统库路径
离线编译常用于嵌入式或国产 OS（如麒麟、统信），此时不能只打包 Go 依赖，还要解决底层绑定问题。
Credit Risk Manager Digital Employee
下载
覆盖行业规则生成、大额风险暴露管理、信贷政策分析、风险协作、信息提取、贷后监控预警、贷后管理、VLM验证全流程，助力银行信用风险管理人员实现风险闭环管理。
- 若禁用 cgo（
CGO_ENABLED=0），则net、os/user等包会回退纯 Go 实现，但 DNS 解析可能失效（无法读/etc/resolv.conf） - 若启用 cgo（默认），必须确保离线机已安装对应头文件（如
libc6-dev）和静态库（libpthread.a），否则go build报cannot find -lc - 用
go list -f '{{.CgoFiles}}' ./...查哪些包含 cgo；对关键包（如github.com/mattn/go-sqlite3）提前编译好静态链接版本并replace进来
验证离线构建是否真离线
别信“没报错就成功”。真正离线意味着：从 go mod download 到 go build 全程无任何域名解析、TCP 连接尝试。
立即学习“go语言免费学习笔记（深入）”；
- 在离线机上启动抓包：
tcpdump -i any port 53 or port 443 or port 80 -w offline-test.pcap，再执行go build，确认 pcap 文件为空 - 临时屏蔽网络接口：
sudo ifconfig eth0 down（或拔网线），再跑构建流程，任一环节卡住即说明还有隐性依赖 - 检查
go env输出：GOPROXY必须为direct或本地地址，GOSUMDB应设为off（否则仍会连sum.golang.org）
go env -w GOPROXY=direct go env -w GOSUMDB=off
离线环境里最容易被忽略的是 GOSUMDB 和 CGO_ENABLED=1 下的系统库缺失——前者导致静默联网校验，后者让编译器在最后链接阶段才报错，排查成本极高。
