Go GOPROXY=off 时为什么仍然找不到本地模块

GOPROXY=off 的含义是“禁止模块下载”，不是“自动使用当前目录或电脑上所有本地目录”。因此，Go 仍找不到本地模块通常不是代理开关失效，而是这个模块没有进入当前构建列表，或者它虽然在模块缓存里，却缺少对应版本文件或校验信息。

先记住一句话：兄弟目录用 go.work 或 replace 接入；已下载版本由 GOMODCACHE 提供；GOPROXY=off 只允许使用已经可解析、可读取的本地来源。

先判断你说的“本地模块”属于哪一层

Go 解析 import 时先看主模块的 go.mod、工作区文件和依赖图，不会因为磁盘上存在 ../common 就自动使用它。若包就在当前模块根目录下，import 必须以 go.mod 中的 module 路径开头；若是兄弟 checkout，就需要显式写进工作区或替换规则。

另一类“本地”是模块缓存，默认在 $(go env GOPATH)/pkg/mod。缓存只代表某个模块版本曾被下载过，不代表任意版本、最新版本或所有 .mod、.zip 文件都齐全。

为什么 GOPROXY=off 仍然报 module lookup disabled

当依赖图里没有提供目标包的模块时，Go 需要查询模块版本和内容；GOPROXY=off 明确禁止这次通信，于是常见错误就是 module lookup disabled by GOPROXY=off。这不是“已经找到本地目录但加载失败”，而是“当前构建没有可用的模块来源”。

先确认实际生效的配置和构建入口：

# 查看当前命令真正使用的模块配置
go env GOPROXY GOSUMDB GOMODCACHE GOWORK
# 查看当前模块和依赖版本，不要凭目录名猜测
go list -m -json all

如果目标是本地兄弟模块，开发期可以使用工作区：

# 在包含两个模块的父目录执行，显式登记本地 checkout
go work init ./service ./common
# 让本次解析只使用工作区中的模块
go env GOWORK
GOPROXY=off go list ./...

也可以在主模块的 go.mod 中使用本地替换：

module example.com/service

go 1.23

require example.com/common v0.0.0

// 开发期把指定版本映射到相邻目录
replace example.com/common => ../common

replace 的左侧仍要和 import 及依赖图中的模块路径一致；只改目录名、不改模块路径，Go 不会因此认出它。

离线缓存和 sumdb 是两条独立的链

如果依赖不是本地 checkout，而是希望复用已经下载的版本，就必须让缓存里有目标版本的 .mod 和源码归档，并让主模块的 go.sum 能完成校验。可以在联网环境先按固定版本预热，再把缓存和 go.sum 一起带入离线环境：

# 联网环境固定版本预热，避免离线时还要解析 latest
go mod download example.com/common@v1.4.2
go mod tidy

# 离线环境只复用已有缓存；缺文件时应回到联网环境补齐
env GOPROXY=off go list -mod=readonly ./...

若错误提到 sum.golang.org，说明源码可能在缓存中，但校验数据库或主模块的 go.sum 仍不满足条件。GOSUMDB=off 只关闭校验数据库查询，不会下载缺失的模块，也不会替代 GOPROXY=off 的来源配置。

对公开依赖，优先提交并复用正确的 go.sum；对确实属于私有模块的范围，应使用 GOPRIVATE 或 GONOSUMDB 精确匹配。只有在受控、可信的离线缓存中，才考虑临时设置 GOSUMDB=off，因为它会放弃未记录模块的数据库认证。

按错误信息做一次反向确认

最后用 GOPROXY=off go list -mod=readonly ./... 做离线复查：能通过，说明依赖图、缓存和校验记录已经闭合；仍失败时，不要继续切换代理地址，先看报错中出现的模块路径和版本，再决定是补缓存还是修本地映射。

相关问题

GOPROXY=off 会读取 go.work 吗？

会。go.work 属于本地工作区配置，不是代理通信；只要 GOWORK 指向有效文件，工作区模块可以在离线条件下参与解析。

设置 GOPRIVATE 能解决本地目录找不到吗？

不能。GOPRIVATE 主要控制代理和校验数据库的访问范围；它不会建立兄弟目录与模块路径之间的映射。

小结：先把“本地目录”和“本地缓存”分开，再检查模块路径、工作区/替换规则以及 go.sum。这样才能知道问题是来源未接入、版本未缓存，还是校验链没有闭合。