本地模块路径不匹配导致“cannot find package”错误，根本原因是replace指令未正确配置：左边必须与import路径完全一致，右边为相对于go.mod的相对路径，且本地模块go.mod中module声明须严格匹配，三者缺一不可。
本地模块路径对不上，go build 就会直接报 cannot find package —— 这不是网络问题，也不是 GOPATH 残留，而是模块系统根本没找到你写的那个包该从哪加载。
go.mod 里必须有 replace 且路径要对得上
Go 不会自动把 ../mylib 当成合法导入源，除非你明说：“这个 import 路径，对应本地文件系统里的哪个目录”。这靠的是 replace 指令，不是靠文件夹位置或 GOPATH。
-
replace左边必须和import语句里的路径完全一致（包括大小写、有无/v2后缀） - 右边是相对于当前
go.mod所在目录的相对路径，用/分隔，Windows 下也别用\ - 如果本地模块自己也有
go.mod，它的module声明必须和 replace 左边的路径匹配 - 执行完
replace修改后，一定要跑go mod tidy，否则不会写入go.sum，下次go build仍可能失败
import 路径和模块名必须一字不差
代码里写 import "mylib/utils"，但本地模块的 go.mod 写的是 module my-lib/utils，或者你漏了 /utils 后缀，Go 就会认为这是两个不同模块。
- 检查所有
import语句：复制粘贴到终端里，用go list -m -f '{{.Path}}' mylib/utils看它是否能解析出模块路径 - 本地模块根目录下的
go.mod第一行module xxx必须和 import 的前缀完全相同 - 不要用
.或空格、中文命名模块名；myapp可以，my app或./mylib不行
GO111MODULE=on 是硬性前提
设成 auto 或 off，Go 就可能退化回 GOPATH 模式，直接忽略 go.mod 和 replace，导致本地路径彻底失效。
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env GO111MODULE，输出必须是on；如果不是，执行go env -w GO111MODULE=on - 确认当前工作目录不在
$GOPATH/src下（比如~/go/src/myproject），否则即使GO111MODULE=on也可能被绕过 - IDE（如 VS Code、Goland）有时会覆盖工作目录或启用旧集成模式，关掉 “Enable Go modules integration” 类选项再试
go mod tidy 不只是拉依赖，它验证整个链路
go mod tidy 是唯一能暴露路径错配问题的命令——它会真正去读 import、查 replace、核对本地模块的 go.mod，然后决定要不要写进主模块的 go.mod。
- 如果
go mod tidy报错cannot find module providing package，说明replace路径指向的目录里没有有效go.mod，或者该目录下压根没.go文件 - 如果
go mod tidy成功但go build仍失败，大概率是缓存污染：运行go clean -modcache清掉$GOPATH/pkg/mod下所有内容再重试 - 不要跳过
go mod tidy直接go build，尤其在改过replace或移动过本地模块之后
最常被忽略的一点：replace 后的本地路径必须可访问、有 go.mod、且模块名与 import 完全一致——三者缺一不可。任何一环断开，Go 都不会“猜”，只会静默失败。
