离线环境不能直接执行go mod download，因其默认依赖网络访问proxy.golang.org或goproxy，而离线机器无外网且未预拉取模块缓存，执行会报“no such host”等连接错误；最稳方案是go mod vendor生成vendor/目录并打包同步，离线构建时加-mod=vendor参数。
离线环境为什么不能直接 go mod download
因为 go mod download 默认依赖网络访问 proxy.golang.org 或你配置的 GOPROXY，而离线机器既无外网，也通常没提前拉取过模块缓存。此时执行会卡住或报错：failed to fetch module: Get "https://proxy.golang.org/...": dial tcp: lookup proxy.golang.org: no such host。
用 go mod vendor + 打包 vendor/ 目录是最稳的离线方案
这不是“导入镜像”，而是把当前项目所有依赖源码完整快照进本地目录，后续编译、构建完全不触网：
-
go mod vendor会在项目根目录生成vendor/文件夹，含全部依赖的.go文件和modules.txt - 确保
GO111MODULE=on（Go 1.16+ 默认开启），且项目已运行过go mod tidy清理过依赖 - 打包时只需同步整个项目目录（含
go.mod、go.sum、vendor/），无需额外工具或服务 - 离线机器上编译时加
-mod=vendor参数：go build -mod=vendor，否则 Go 仍会尝试联网解析
想复用已有模块缓存？必须提前导出 GOMODCACHE
如果你有另一台同架构、同 Go 版本的联网机器，并已缓存大量模块，可手动复制 GOMODCACHE 目录到离线机 —— 但要注意路径和权限细节：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 先查缓存位置：
go env GOMODCACHE，常见如$HOME/go/pkg/mod - 压缩整个
pkg/mod目录（保留子目录结构），传到离线机对应用户家目录下 - 离线机需确保
go env GOPATH和原机器一致；若不一致，要么改离线机GOPATH，要么解压到正确路径 - 必须重置
go env -w GOSUMDB=off（否则校验失败），且首次使用前建议运行go mod download -x观察是否真能命中缓存
别碰 go install golang.org/x/tools/... 类命令
离线环境下，VSCode 的 Go 插件依赖的 gopls、goimports 等二进制工具无法自动下载。强行在离线机运行 go install 会失败，且错误信息模糊（如 no required module provides package）。
正确做法是：在联网机用相同 Go 版本执行：
-
GOOS=linux GOARCH=amd64 go install golang.org/x/tools/gopls@latest（按目标平台交叉编译） - 找到生成的二进制（如
$GOPATH/bin/gopls），拷过去，再在 VSCode 设置里指定"go.goplsPath"路径
真正麻烦的从来不是模块本身，而是工具链二进制的平台适配和校验绕过 —— 这部分最容易被文档忽略。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
