replace只在当前项目生效，因为它是go.mod的本地解析规则，不作为模块元数据传递给下游；下游模块仍按自身go.mod解析依赖，不会继承上游的replace规则。
replace 为什么只在当前项目生效
因为 replace 是 go.mod 的本地解析规则，不是模块元数据的一部分。Go 工具链在解析依赖时，只读取当前模块的 go.mod，不会把里面的 replace 规则“传递”给下游模块——哪怕下游模块 import 了你这个模块，它依然按自己的 go.mod 解析依赖。
这意味着：如果你在项目 A 中写了 replace github.com/x/y => ./local-y，然后发布模块 A 到 GitHub，别人 go get A 后构建，github.com/x/y 还是走远程下载，除非他们自己也加了这条 replace。
- 无法通过
require间接继承replace -
go list -m all输出里能看到被替换的模块路径已变，但go mod graph不会显示替换关系 - CI 构建失败常见原因：替换成
./xxx，而 CI 环境没有该目录或路径不一致
本地路径替换必须满足的三个硬性条件
写 replace old/path => ./local-dir 看似简单，但只要漏掉一个条件，Go 就直接忽略整行，不报错也不提示。
-
./local-dir必须是相对于当前go.mod所在目录的路径（不能是../sibling跨出项目根目录，除非你明确知道 GOPATH 或 module 根位置） -
./local-dir下必须存在合法的go.mod文件，且其中module声明必须与old/path完全一致（包括大小写、末尾斜杠、v2/v3 路径后缀） -
old/path必须和代码中import语句里的路径一字不差——比如import "github.com/sirupsen/logrus"，就不能写成replace github.com/Sirupsen/logrus => ...（大小写错）
验证方式很简单：go mod tidy 后看 go list -m old/path 输出是否变成 old/path => ./local-dir；如果还是显示远程版本，说明某条条件没满足。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
用 commit hash 替换远程分支时的版本写法陷阱
想临时用某个未打 tag 的 fork 分支？别写 replace github.com/x/y => github.com/yourname/y master —— Go 不认 master 这种 ref 名，它只认语义化版本或 pseudo-version。
- 正确写法是：
replace github.com/x/y => github.com/yourname/y v0.0.0-20260804123456-abcdef123456，其中时间戳 + commit hash 必须来自该仓库的 Git 日志（可用git log -n1 --format="%cd-%h" --date=short生成） - 错误写法：
replace github.com/x/y => github.com/yourname/y v1.2.3—— 如果你的 fork 没打v1.2.3tag，Go 会去原仓库找，结果还是拉不到你的代码 - 更稳妥的做法：先在 fork 仓库打一个带前缀的 tag，比如
v1.2.3-myfix，再写replace github.com/x/y => github.com/yourname/y v1.2.3-myfix
replace 和 go.work 的分工边界在哪
单模块快速验证用 replace，多模块长期协作开发就该切到 go work。这不是功能强弱问题，而是责任归属不同。
-
replace改的是当前模块的go.mod，每个子模块都要单独维护自己的替换规则，容易遗漏或冲突 -
go work在工作区根目录建go.work，用use ./module-a ./module-b声明参与模块，所有模块共享同一套本地路径映射，且不污染各子模块的go.mod - 注意：
go work不会自动处理跨模块的replace冲突——比如 module-a 和 module-b 都想替换同一个依赖，得靠人工协调
真正容易被忽略的点是：一旦启用了 go work，go mod 命令默认作用于工作区，而不是单个模块；此时再在某个子模块里改 go.mod 的 replace，可能根本不起作用。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
