go build时符号从replace指定的路径加载，而非require声明的版本；实际来源由go list -m all输出的解析结果决定，需确保replace左右路径、本地go.mod module名及import语句四者严格一致。
go build 时符号到底从哪个版本加载
Go 不会在运行时动态选择符号来源，所有符号在链接期就已确定。你 import 的包路径（如 github.com/sirupsen/logrus）对应唯一一个模块实例，而这个实例由 go list -m all 输出的最终解析版本决定——不是你 require 的版本，也不是间接依赖声明的版本，而是 MVS（最小版本选择）算法算出的那个“满足全部约束的最低可行版本”。
常见误解是：“A 用了 v1.8，B 用了 v1.10，所以编译后会有两套 logrus 符号”。实际上不会。Go 强制统一为一个版本，所有 import 都指向它。只有路径不同（如 github.com/sirupsen/logrus/v2）才会触发真正隔离的符号空间。
- 如果两个模块都 import
github.com/sirupsen/logrus，哪怕它们各自require不同 minor 版本，最终也只加载一个v1.x实例 -
replace会改变该路径最终指向的代码，但不新增符号命名空间；它只是把原路径“重定向”到另一份源码 - 符号冲突只发生在同一路径下 API 不兼容时（比如 v1.9 删除了某个函数，而某依赖仍调用它），这时编译失败，不是链接期报错，而是类型检查阶段中断
replace 如何影响符号解析路径
replace 不是“加载多个版本”，而是“让某个导入路径在构建时指向别的源”。它生效于模块解析阶段，在 go build 开始前就完成了路径映射。
例如你在 go.mod 中写：
replace github.com/sirupsen/logrus => ./vendor/logrus-fix
那么所有原本要加载 github.com/sirupsen/logrus 的地方，都会去读取 ./vendor/logrus-fix 目录下的代码，并按其 go.mod 声明的模块路径和版本参与 MVS 计算。
- 如果
./vendor/logrus-fix/go.mod声明的是module github.com/sirupsen/logrus，那它就完全替代官方版本，符号表来自本地代码 - 如果它声明的是
module github.com/sirupsen/logrus/v2，那它不会替代v1路径，只是新增一个独立路径，v1和v2符号互不干扰 -
replace后必须运行go mod tidy，否则可能残留旧缓存，导致go list -m all显示的仍是原始版本
如何验证符号实际来自哪个版本
不能只看 go.mod 里的 require 行，得查构建时真实解析结果。
- 运行
go list -m all | grep logrus：输出形如github.com/sirupsen/logrus v1.9.0或github.com/sirupsen/logrus v0.0.0-20230510142234-a1b2c3d，后者说明用了 commit 替换 - 配合
go mod graph | grep logrus可看到谁拉入了这个版本，比如my/project github.com/sirupsen/logrus@v1.9.0表示主模块直接引入 - 想确认某函数是否来自替换后的代码？在本地替换目录里加个临时
fmt.Println("from local fix")，再go build运行看输出——这是最直白的验证方式
符号重定向失败的典型表现
你以为 replace 生效了，但实际没起作用，往往是因为路径或版本声明不匹配。
- 替换路径未包含
go.mod文件，或其中module名与被替换路径不一致 →go build报错：replaced module's path differs from replacement path - 替换目标是私有仓库但未配置
GOPRIVATE→go get卡住或报unrecognized import path - 执行
go mod tidy前手动改了go.mod，但没更新go.sum→ 构建时校验失败，提示checksum mismatch - IDE（如 VS Code）没重载工作区，仍缓存旧模块信息 →
gopls跳转错误、类型提示缺失，但命令行构建正常
真正麻烦的不是多版本共存本身，而是路径一致性被破坏：模块路径、import 语句、replace 声明、go.sum 校验项，四者必须严格对齐。差一个字符，符号就可能加载错地方。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
