踩坑记录：内网隔离无外网环境下 Go 编译报错 cannot find module

问题背景

在内网隔离、禁止连接外网的环境（如 VDI 虚拟桌面、企业内网机房、物理断网服务器等）下进行 Go 项目开发时，本地通过 IDEA 的 File Transfer 将代码同步到远程 Linux 服务器。远程服务器绝对无外网，且项目根目录下依赖 vendor 目录。

执行编译脚本时，终端抛出如下错误：

pkg/core/client/utils/download_files.go:13:2: cannot find module providing package golang.org/x/net/html: import lookup disabled by -mod=vendor
	(Go version in go.mod is at least 1.14 and vendor directory exists.)

错误原因分析

这个错误的核心在于 Go 编译器的依赖查找机制 与 IDE 文件同步不完整 之间的冲突。

1. Go 1.14+ 的默认行为：当项目根目录下存在 vendor 目录，且 go.mod 中声明的 Go 版本大于等于 1.14 时，Go 编译器会默认启用 -mod=vendor 模式。编译器强制只从 vendor 目录中寻找依赖，无视其他一切缓存。
2. 内网隔离与文件同步：由于远程服务器严格禁止外网，无法下载依赖。而通过 IDEA 的 File Transfer 同步数千个 vendor 目录下的小文件时，极易发生超时、卡顿或漏传。
3. 最终结果：编译器在 vendor 目录中找到了部分包，但恰好缺失了 golang.org/x/net/html 的源码文件，导致报错。

解决方案（仅限无外网环境）

在断网隔离环境下，任何试图通过网络拉取或重新生成依赖的命令（如 go mod download、go mod vendor）都是徒劳的。唯一的解法是确保本地完整的 vendor 目录被 100% 传输到服务器。

方案一：压缩包传输法（最靠谱、最推荐）

不要使用 IDE 的文件同步去传 vendor 目录，几万个小文件绝对会出问题。请采用以下步骤：

1. 本地打包：在你的本地开发机（Windows/Mac）上，将完整的 vendor 目录压缩为 vendor.zip 或 vendor.tar.gz。
2. 单文件上传：使用 Xftp、WinSCP 等工具，将压缩包上传到服务器的项目根目录下。
3. 远程解压覆盖：

   cd /path/to/your/project
   rm -rf vendor        # 删掉服务器上残缺的 vendor
   unzip vendor.zip     # 或 tar -zxvf vendor.tar.gz

方案二：IDEA 强制对比同步（适用于只差几个文件）

如果你确信只漏传了几个文件，可以尝试通过 IDE 强制同步。

1. 在 IDEA 中右键点击项目根目录。
2. 选择 Deployment -> Sync with Deployed to...。
3. 仔细检查右侧的差异列表，确认缺失的文件并点击上传。

💡 内网隔离/离线开发环境的避坑建议

1. 屏蔽 vendor 的自动同步：在 IDEA 中，右键 vendor 目录 -> Mark Directory as -> Excluded。日常开发只同步你修改的源码（.go 文件），不要让 IDE 去碰庞大的 vendor。
2. 依赖更新流程：每次在本地更新了 go.mod，本地执行完 go mod vendor 后，直接打包整个 vendor 目录传服务器。永远不要依赖 IDE 的增量同步来传依赖。
3. 内网 GOPROXY（进阶）：如果内网有其他开发同事也面临此问题，可以在内网找一台有网的机器搭建一个私有的 GOPROXY（如 Athens），或者直接把 $GOPATH/pkg/mod 目录打包拷贝过去，彻底告别 vendor 的折磨。