no required module provides package 错误主因是当前路径不在任一模块根目录且父目录存在 go.mod，导致启用 module 模式却找不到对应模块定义；需确认 pwd 与 go.mod 路径一致，排查隐藏 go.mod，或用 go111module=off go build 验证是否为上下文错位。
多模块联合编译冲突不是“多个go.mod共存”本身导致的，而是模块路径、依赖解析边界或构建上下文错位引发的——go build 会按当前目录向上查找最近的 go.mod，一旦跨模块目录执行命令，就容易误入错误的模块上下文，进而触发版本不一致、包找不到或 no required module provides package 等报错。
go build 报 no required module provides package 的真实原因
这不是依赖没装全，而是 Go 当前工作目录不在任一模块根目录下，或父目录存在另一个 go.mod，导致它自动启用 module 模式却找不到对应模块定义。
- 运行
pwd（macOS/Linux）或cd（Windows），确认终端当前路径和go.mod所在路径完全一致 - 用
find . -name "go.mod" -path "./[a-zA-Z0-9_]*"查找附近是否有隐藏的、不该存在的go.mod（比如上级vendor目录或测试子目录里误建的） - 临时禁用 module 模式验证是否是路径问题：
GO111MODULE=off go build main.go—— 若成功，说明问题纯属模块上下文错位，不是代码缺陷
多个 go.mod 共存但互相 import 时的路径陷阱
Go 不允许直接用相对路径（如 ./lib）或本地路径（如 file:///home/user/mylib）作为模块名导入；否则 go get 无法解析，go mod tidy 会失败。
- 每个子模块必须有合法的模块路径，例如
github.com/yourname/project/core、github.com/yourname/project/api，不能是core或../core - 主模块
go.mod中通过replace指向本地路径仅用于开发调试：replace github.com/yourname/project/core => ../core，上线前必须删掉或改用真实版本号 -
replace不会传递给下游模块——如果 A 依赖 B，B 用了replace，A 的go mod tidy不会继承该替换，需各自声明
vendor 目录与 go mod 同时启用时的冲突表现
启用 go mod 后再保留 vendor 目录，会导致 Go 在不同场景下选择不同依赖来源：构建时可能用 vendor，go list 却读 go.sum，造成行为不一致。
- 统一策略：要么彻底禁用 vendor（
go mod vendor后删掉目录，并确保GOFLAGS="-mod=mod"），要么全程只用 vendor（GO111MODULE=on go mod vendor后设GOFLAGS="-mod=vendor"） - CI/CD 中强烈建议不用
vendor：它掩盖了go.sum校验失效的风险；go mod download+go mod verify更轻量且可审计 - IDE（如 VSCode）若提示 “package not found”，先检查状态栏右下角是否显示 “Loading modules…” —— 这常因 vendor 存在但
gopls未正确识别模块边界所致
混合语言编译（如 Go + C/Rust）中模块隔离失效
当 Go 模块被编译为 C 静态库（--buildmode=c-archive）供外部调用时，若 CMake 或 Makefile 未严格隔离构建目录，会导致 go build 被触发在错误路径，从而污染主模块的 go.mod。
- CMake 中调用 Go 编译时，务必指定
SOURCE_DIR和BUILD_IN_SOURCE OFF，避免在项目根目录生成临时go.mod - 不要在
go.mod所在目录下运行cmake .. && make；推荐将 Go 子模块放在third_party/go-core/这类隔离路径，并在 CMakeLists.txt 中显式set(CMAKE_CURRENT_SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/third_party/go-core) - 若使用
//export导出函数，确保CGO_ENABLED=1且头文件路径不依赖当前工作目录（用绝对路径或-I${CMAKE_CURRENT_SOURCE_DIR}/include）
真正棘手的点往往藏在模块边界的“缝隙”里：比如一个 go.mod 文件被 IDE 自动生成在错误子目录、CI 脚本 cd 到了上层目录却没重置 GOPATH、或是 replace 规则写错斜杠方向。这些地方不会报语法错误，但会让 go build 在静默中选错模块上下文——查的时候得盯着 go env GOMOD 输出看它到底加载了哪个 go.mod。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
