go.mod 不能放在 GOPATH 下统一管理，因模块机制以项目根目录为作用域，不认 GOPATH；多项目共用 go.mod 会导致版本冲突、replace 失效及构建失败。
为什么 go.mod 不能放在 GOPATH 下统一管理
Go 1.11 引入模块（module）后，go.mod 的作用域就是当前模块根目录，它不认 GOPATH，也不支持“全局依赖锁”。把多个项目强行塞进一个 go.mod，会导致版本冲突、replace 失效、go list -m all 输出混乱，甚至 go build 随机失败。
真实场景中，跨项目依赖通常指：A 项目想复用 B 项目的某个内部包（比如 github.com/org/b/pkg/util），但 B 尚未发布稳定 tag，或你正在本地联调。
- 正确做法是每个项目独立
go mod init，各自维护go.mod - 跨项目引用必须走远程路径（如
github.com/org/b），即使本地开发，也要确保该路径能被go get解析 - 本地修改 B 时，A 项目需用
replace指向本地路径，且该replace只应存在于 A 的go.mod中，不可提交到 B
如何在 A 项目中安全 replace 本地 B 项目
replace 是临时绑定本地路径的唯一标准方式，但它极易出错：路径写错、忘记加 // indirect 标记、误提交到主分支、与 require 版本不匹配都会导致 CI 构建失败。
操作前确认 B 项目已初始化模块且有合法 module github.com/org/b 声明（在 B 的 go.mod 第一行）。
立即学习“go语言免费学习笔记（深入）”；
cd /path/to/a-project go mod edit -replace github.com/org/b=/path/to/local/b go mod tidy
执行后检查 A 的 go.mod 是否新增了：
replace github.com/org/b => /path/to/local/b
- 路径必须是绝对路径（
go mod edit会自动补全） - 如果 B 项目没有打 tag，A 的
require行仍需指定一个伪版本（如v0.0.0-20240520123456-abcdef123456），go mod tidy会自动填充 - CI 环境必须移除
replace，否则构建找不到本地路径 —— 推荐用make dev-deps脚本封装替换逻辑，主流程保持 clean
当 B 项目要拆成多个子模块（如 b-core / b-api）怎么办
Go 不支持“单仓库多模块”开箱即用。若 B 目录下有 b-core/ 和 b-api/ 两个独立功能区，又希望它们版本解耦，就必须为每个子目录单独初始化模块：
cd /path/to/b go mod init github.com/org/b-core cd b-api go mod init github.com/org/b-api
此时 A 项目引用方式变为：
require (
github.com/org/b-core v0.1.2
github.com/org/b-api v0.3.0
)
- 每个子模块都有自己的
go.mod和版本生命周期 - B 仓库根目录可保留空
go.mod（仅用于 git 管理），但不应被任何项目直接require - 注意 import 路径必须与
module声明完全一致：A 中写import "github.com/org/b-core"，不能少-core - 发布时需分别为每个子模块打 tag：
git tag b-core/v0.1.2、git tag b-api/v0.3.0
vendor 目录是否还能解决跨项目依赖问题
不能。自 Go 1.14 起，go mod vendor 仅打包当前模块的直接和间接依赖，不会包含你 replace 进来的本地路径内容。也就是说，即使你 go mod vendor 后提交了 vendor/，A 项目在另一台机器上运行 go build 仍会尝试拉取 github.com/org/b —— 因为 replace 不进 vendor。
- vendor 本质是缓存远程依赖的副本，不是替代模块机制的方案
- 若真需要离线构建，应在 CI 中先
go mod download，再打包整个GOPATH/pkg/mod缓存目录 - 对私有模块，应配置
GO_PRIVATE或GOPROXY，而非依赖 vendor
最易被忽略的一点：所有 replace 必须在 go.mod 文件中显式存在，且路径不能含 ~ 或环境变量。Go 工具链不会展开 shell 语法，也不会读取 .bashrc —— 写 replace github.com/org/b => ~/src/b 会导致 go build 报错 no matching versions for query "latest"。
