replace语句必须写在主模块的go.mod中且仅对当前模块生效，需配合go mod tidy更新依赖并验证go list -m输出，不可用于标准库或golang.org/x/…包。
replace 语句必须写在 go.mod 文件里，且只对当前模块生效
Go 的 replace 是模块级重定向机制，不是运行时或构建时的路径替换。它只影响 go build、go test 等命令解析依赖时的行为，且仅作用于当前模块的 go.mod 文件所声明的依赖树。
常见错误是把 replace 写在被调试包自己的 go.mod 里——这毫无意义，因为你要调试的是“被依赖方”，真正需要修改的是**调用方（主模块）** 的 go.mod。
-
replace github.com/user/pkg => ./local/pkg：本地相对路径必须存在且包含有效的go.mod（或至少有package声明） -
replace github.com/user/pkg => ../pkg：支持上层目录，但不能跨 GOPATH 或 module root 边界（Go 1.18+ 对此更宽松，但仍建议保持路径可解析） - 如果本地包尚未初始化模块，需先在该目录下运行
go mod init github.com/user/pkg
调试时 replace 后要重新 tidy，否则旧缓存可能干扰
执行 replace 修改后，不运行 go mod tidy 是最常被忽略的步骤。Go 不会自动更新 go.sum 或清理旧版本缓存，可能导致：
- 构建仍拉取远程 v1.2.3 版本，无视
replace -
go list -m all显示两行：github.com/user/pkg v1.2.3和github.com/user/pkg v0.0.0-00010101000000-000000000000（后者才是 replace 生效的标记） - ide（如 vs code + gopls）未刷新依赖，跳转仍去远程代码
务必执行：
立即学习“go语言免费学习笔记（深入）”；
go mod tidy go mod verify验证是否生效：运行 go list -m github.com/user/pkg，输出应为类似 github.com/user/pkg v0.0.0-00010101000000-000000000000 => ./local/pkg。
replace 不能用于标准库或 golang.org/x/… 的子包（除非用 GODEBUG=gomod=off）
Go 对标准库和 golang.org/x/... 包有特殊处理机制。replace 对它们默认无效，尝试写：
replace golang.org/x/net => ./forked-net会导致 go build 报错：replacing golang.org/x/net is not allowed。
绕过限制的唯一可行方式（仅限调试）：
- 临时设置环境变量：
GODEBUG=gomod=off go build - 此时 Go 退回到 GOPATH 模式，忽略
go.mod和replace，改用$GOPATH/src/下的源码 - 注意：这会禁用整个模块系统，所有依赖都按 GOPATH 查找，不可用于 CI 或生产
修改本地包后，主模块需显式 rebuild，go run 不自动 reload
Go 没有热重载。即使你用 replace 指向本地包，每次修改 ./local/pkg 后，主模块仍需手动触发重建：
-
go build或go run main.go才会重新编译并链接最新本地代码 - 某些 IDE 的 “Run” 按钮可能缓存二进制，建议终端执行命令确保干净
- 如用
air或reflex等热重载工具，需配置监听./local/pkg/**/*路径，否则只监听主模块文件
一个简单验证方式：在本地包函数里加一行 fmt.Println("DEBUG: patched")，再运行主程序看是否输出——这是判断 replace 是否真正在起作用的最快方法。