报错“no required module provides package”说明当前目录无go.mod文件，go无法识别模块依赖；需先在项目根目录执行go mod init初始化模块，再用go get或go mod tidy添加依赖。
go run 时提示 no required module provides package
这说明 Go 已进入 module 模式，但当前项目没有声明对那个包的依赖。不是“没装”，而是“没声明”——go.mod 里没记录，Go 就不认这个包。
常见现象是：刚写完 import "github.com/gin-gonic/gin"，直接 go run main.go 就报错，终端还贴心地提示 to add it: go get github.com/gin-gonic/gin。但这句提示有误导性：它默认你已有 go.mod；如果你连 go.mod 都没有，go get 实际不会写入依赖。
- 先检查当前目录及所有父目录有没有
go.mod：find . -name "go.mod" -path "./**"（Linux/macOS）或手动逐级ls - 如果真没
go.mod，别急着go get，先执行go mod init myproject（模块名可任意，但建议带域名前缀如example.com/myapp） - 初始化后，再运行
go get github.com/gin-gonic/gin或直接go mod tidy，依赖才会真正写进go.mod和go.sum
报错说 go.mod file not found in current directory or any parent
这是最底层的信号：Go 根本没找到任何 go.mod，连 module 模式都没激活，但它又试图按 module 规则解析 import，于是直接放弃。
原因通常是：你在非项目根目录下执行命令，或者下载的开源项目缺了 go.mod 文件（比如只 clone 了子目录）。也可能是你用旧版 Go（GO111MODULE 被设为 off，但这种情况在 2026 年已极少见。
- 确认当前工作目录是否真是项目根目录——
go.mod应该和main.go在同一级 - 如果确定该有却没了，运行
go mod init example.com/yourapp补上（注意：模块名不能含空格、不能以点开头） - 避免在 GOPATH/src 下随意建项目，尤其当
GO111MODULE=auto时，Go 可能因路径落入 GOPATH 而退回到老式查找逻辑
go get 之后 still no required module provides package
执行了 go get 还报同样错，大概率是 import 路径和实际模块路径不匹配。Go 不靠文件夹名推断，只认 go.mod 第一行的 module 声明 + import 语句里的字符串。
典型场景：你把 frontend/ 目录重命名为 frontend-src/，但代码里仍写 import "github.com/org/repo/frontend/schema" —— Go 会去查 github.com/org/repo/frontend 这个模块，而你本地只有 frontend-src，远程也没有这个路径的 tag 或 branch。
- 打开出错的
import行，核对字符串是否与目标仓库的实际 import path 完全一致（包括大小写、拼写、子路径） - 检查目标模块是否真发布了——访问
https://pkg.go.dev/github.com/xxx/yyy看能否打开文档页 - 如果用的是私有库，确认
GOPRIVATE是否设置了对应域名，否则 Go 会跳过校验直接失败
为什么 go mod tidy 没自动加依赖？
go mod tidy 只会添加代码中「实际使用」的包。如果你 import 了某个包但没在函数里调用任何符号，Go 认为这是死代码，不会拉取也不会写进 go.mod。
例如：import "net/http" 但整份代码里没出现 http. 开头的调用，go mod tidy 就会删掉这行 import（或压根不加）。这不是 bug，是 Go 的严格依赖修剪机制。
- 确保 import 后至少有一处调用，比如
http.HandleFunc或http.Get - 如果只是想预装依赖（比如为 CI 准备 vendor），可用
go get -d github.com/xxx/yyy（-d表示只下载不构建） - 慎用
go mod vendor：它会复制所有依赖到本地vendor/目录，但现代 Go 推荐直接依赖go.mod，除非你有强隔离需求
真正的难点不在命令怎么敲，而在理解 Go 的 module 是基于声明而非文件系统的——import 字符串、go.mod 的 module 名、远程仓库的路径，三者必须对得上，缺一不可。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
