因为Go默认使用模块缓存中的只读副本，不感知本地replace路径下的代码变更；需在go.mod中用replace显式指向含匹配module声明的本地路径，且避免go mod tidy覆盖replace。
为什么 go run 或 go build 不加载本地修改的依赖？
因为 Go 默认使用模块缓存（$GOPATH/pkg/mod）中的只读副本，即使你改了本地 replace 指向的代码目录，只要缓存里已有该版本的 zip 解压内容，Go 就不会重新拉取或同步——它根本不会去看你 replace 路径下的文件是否变了。
如何让本地修改实时生效？
关键不是“刷新缓存”，而是让 Go 工具链绕过缓存、直接读取你正在编辑的源码。必须同时满足两个条件：
- 在
go.mod中用replace显式指向本地路径，例如：replace github.com/foo/bar => ../bar - 确保本地路径下有完整的模块结构：包含
go.mod文件，且模块路径（module声明）与被替换的原始路径一致 - 每次修改后，不需要手动清理缓存，但要避免执行
go mod tidy—— 它可能把replace行删掉或覆盖成远程版本
replace 后仍报 “missing required module” 怎么办？
这是典型路径不匹配：你 replace 的模块路径和本地 go.mod 里的 module 声明不一致。比如你在 go.mod 写了 replace example.com/a => ./a，但 ./a/go.mod 里写的是 module github.com/x/a，Go 就会拒绝加载。
验证方法：go list -m all | grep a，看输出中对应模块是否显示为 => ./a；如果显示远程路径或报错，就说明 module 声明对不上。
立即学习“go语言免费学习笔记（深入）”；
开发多个相互依赖的本地模块时怎么组织？
不要靠相对路径硬写 replace，容易出错且难维护。推荐做法：
- 所有本地模块统一放在一个父目录下，比如
~/dev/myproject/ - 每个子模块用绝对路径
replace，例如：replace github.com/org/lib => /home/user/dev/myproject/lib - 用
go mod edit -replace=...命令批量更新，避免手误 - 提交前务必删掉
replace行，或用// +build ignore注释临时隔离，否则 CI 会失败
最常被忽略的一点：Go 不会监听文件变化，改完代码必须重新运行 go run 或 go build，没有热重载。哪怕用了 replace，也得手动触发构建。
