go mod tidy报unknown revision或module not found，是因为本地模块缺go.mod、replace位置错误、路径计算不准或module名大小写不一致；需确保主模块和本地模块均有go.mod、replace写在末尾、路径与module名完全匹配。
直接用 replace 就能解决，但必须满足三个前提：主模块有 go.mod、本地模块根目录也有 go.mod、replace 左侧的模块路径要和 require 中声明的一致。
为什么 go mod tidy 报 unknown revision 或 module not found
Go 工具链找不到目标模块，不是因为你没写 import，而是它压根没法解析那个路径。常见原因包括：
- 本地模块目录下没有
go.mod文件（哪怕只有一行module github.com/user/utils也行） -
replace写在了go.mod开头或中间，而 Go 只认末尾的replace块 - 相对路径算错了：比如主模块
go.mod在~/proj/，你写replace github.com/user/utils => ./utils，但实际本地模块在~/utils/，就得写=> ../utils - 模块名大小写不一致：本地
go.mod是module GitHub.com/User/Utils，但replace写的是github.com/user/utils，Go 视为不同模块
怎么写正确的 replace 行
必须紧贴 go.mod 文件末尾，格式严格，不能多空格、不能换行、不能加注释。例如：
require github.com/user/utils v0.1.0 replace github.com/user/utils => ../utils
注意几点：
- 左侧模块路径必须已在
require中出现过，否则go mod tidy会直接忽略这行 - 右侧路径支持相对路径（推荐）或绝对路径，但不能以
./开头（Go 不允许） - 本地模块的
go.mod第一行module声明必须和replace左侧完全一致，包括协议、域名、大小写、路径斜杠 - 执行完后立刻跑
go mod tidy，它会验证本地路径是否可读、是否有合法go.mod，并更新go.sum
验证本地依赖是否真被用了
别只看编译通过，得确认运行时加载的是你改的代码：
- 运行
go list -m all | grep utils，输出里应含=> ../utils或类似重定向提示 - 在本地模块里加个
fmt.Println("from local")，再go run main.go，看是否打印 - 改本地模块里的函数返回值，重新构建，检查行为是否同步变化
- 如果 CI 构建失败，大概率是忘了删
replace—— 它不会自动消失，也不会传递给下游
最容易被忽略的是：本地模块的 go.mod 必须存在且 module 名匹配，否则 replace 形同虚设；还有就是相对路径基于主模块 go.mod 位置计算，不是当前 shell 路径。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
