答案是import路径不合法或缺失版本号所致，需检查所有import语句是否匹配已声明module、确保本地子模块有独立go.mod并用replace显式关联，且replace必须位于require块后、indirect前，路径与大小写须完全一致。
go mod tidy 报错 “require …: version is required”
这是最常见的现象：项目根目录有 go.mod，但执行 go mod tidy 时突然报错，提示某个模块缺少版本号。根本原因不是网络或代理问题，而是你本地代码里写了不合法的 import，比如：import "myproject/utils" 这种未声明 module path 的路径，或者 import 了尚未被 go.mod 管理的本地子目录。
解决方法很直接：
- 检查所有
.go文件里的import语句，确保每个路径都对应一个已声明的 module（即该路径必须能被 Go 工具链解析为远程 URL 或本地 replace 路径） - 如果想引用本地子模块（如
./pkg/http），它必须有自己的go.mod，且父模块需通过replace显式声明，例如：replace myproject/pkg/http => ./pkg/http - 删掉临时测试用的、没走模块管理的 import，比如
import "./utils"或import "utils"—— Go 不允许这种相对路径或裸包名
本地 replace 不生效，go build 仍拉远端版本
你写了 replace github.com/some/lib => ./vendor/some-lib，但 go build 时还是去 fetch 远端 v1.2.3，说明 replace 没起作用。常见原因是：go.mod 里该模块的 require 行版本号和 replace 目标不匹配，或者 replace 写在了错误位置（比如写在了 // indirect 注释后面）。
实操要点：
-
replace必须写在require块之后、indirect注释之前；Go 1.17+ 对顺序更敏感 - 确保
replace左侧的 module path 和require中完全一致（包括大小写、斜杠方向） - 替换目标路径必须是绝对路径或相对于当前
go.mod的相对路径，且该路径下必须存在有效的go.mod文件 - 执行
go mod edit -print查看实际生效的模块图，确认 replace 是否被加载
go list -m all 显示大量 indirect 依赖，且部分标为“missing”
这说明你的代码里引用了某个包，但它的 module 没出现在 go.mod 的 require 列表中，Go 只能靠间接推导，而推导失败（比如该包已被删库、重命名，或你本地删了 vendor 但没清理缓存）。
不要直接删 go.sum 或硬加 require 行。优先做这几件事：
- 运行
go mod graph | grep missing定位哪个包在拖拽这个“missing”依赖 - 检查对应
.go文件的 import，确认是否误用了已归档/改名的库（比如gopkg.in/yaml.v2换成github.com/go-yaml/yaml/v2） - 如果是自己写的本地包被误标为 indirect，说明它没被任何非-test 文件 import —— 检查是否只在
xxx_test.go里用了它 - 临时用
go get -u更新一级依赖，有时能自动修复间接链断裂
修改本地包后 go run 仍用旧代码
你改了 ./internal/log 里的函数，但 go run . 没生效，甚至 go mod graph 里都看不到这个路径 —— 因为 Go 默认不会把未被 require 或 replace 的本地目录纳入构建范围，它只认 module path，不认文件系统路径。
真正起作用的只有两种方式：
- 把这个本地包发布为独立 module（带
go.mod），然后在主项目require它 +replace到本地路径 - 或者，把它作为主 module 的一部分：确保它的 import path 是主 module path 的子路径（如主
go.mod是module example.com/app，那么import "example.com/app/internal/log"才合法） - 切忌用
import "./internal/log"或import "log"这类写法 —— Go 会忽略或报错，且无法触发 rebuild
最易被忽略的一点：Go 缓存的是 module content hash，不是文件 mtime。改了代码但没改版本号或没触发 go mod tidy，go build 可能直接复用旧 cache。遇到“怎么改都不生效”，先 go clean -modcache 再试。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
