Go项目无法使用第三方包，主因是模块未初始化、import路径错误或代理未配置；需先执行go mod init初始化模块，确保import路径与模块定义一致，并设置GOPROXY=https://goproxy.cn,direct。
Go 项目里用不了第三方包，八成不是网络问题，而是模块没初始化、路径写错、或代理没配对——先检查这三项，90% 的 cannot find module providing package 错误当场解决。
go mod init 必须在项目根目录执行
没 go.mod 文件，Go 就默认走旧的 GOPATH 模式，所有 import 都会找不到第三方路径。哪怕你只写了一行 import "github.com/gin-gonic/gin"，也得先确保当前目录是项目根，并运行：
go mod init example.com/myapp
模块名不用对应真实域名，但不能是纯数字或含空格；如果项目已有 go.mod，就别重复 init，否则会覆盖依赖记录。
- 执行后检查是否生成了
go.mod和go.sum，且第一行是module xxx - 如果
go get不往go.mod里写依赖，大概率是你 cd 错了目录，不是当前模块根 - GO111MODULE=off 会强制禁用模块模式，用
go env -w GO111MODULE=on强制打开
import 路径必须和模块定义完全一致
Go 的 import 是模块路径，不是包名，也不是本地文件夹名。比如你 go get github.com/go-sql-driver/mysql，代码里必须写：
立即学习“go语言免费学习笔记（深入）”；
import "github.com/go-sql-driver/mysql"
而不是 import "mysql" 或 import "./mysql"。常见翻车点：
- 把
gopkg.in/yaml.v2写成gopkg.in/yaml.v3—— v2 和 v3 是两个独立模块，路径不同，不能混用 - 看到别人代码里写了
import "gin"就照抄 —— 这是错的，gin是包名（package gin），不是导入路径 - 从 GitHub 页面复制 URL 时多按了一个 /，比如写成
github.com/gin-gonic/gin/（末尾斜杠）—— Go 会报路径无效
go get 必须带版本或由 build 触发
go get github.com/sirupsen/logrus 这种不带版本的命令，在 Go 1.16+ 默认拉 latest commit，行为不可控。生产环境应锁定版本：
go get github.com/sirupsen/logrus@v1.9.3
更稳妥的做法是：先写好 import，再直接 go build 或 go run main.go，Go 会自动下载并写入 go.mod —— 这比手动 go get 更少出错。
- 执行后检查
go.mod中是否新增了require github.com/sirupsen/logrus v1.9.3 - 国内用户必须配代理，否则超时或 404：
go env -w GOPROXY=https://goproxy.cn,direct - 想只下载不编译，加
-d参数：go get -d github.com/spf13/cobra@v1.8.0
vendor 不是默认启用，-mod=vendor 必须显式加
很多人生成了 vendor/ 目录，却仍报 cannot find module providing package，是因为 Go 默认不读 vendor —— 它只在你明确告诉它“用 vendor”的时候才用：
go build -mod=vendor
没这个参数，Go 照样去远程 fetch，和有没有 vendor/ 无关。
- 每次改了
go.mod或执行go mod tidy后，必须重跑go mod vendor同步内容 -
go mod verify可校验vendor/是否和go.mod一致，不一致就说明漏文件了 - CI 场景下，
go mod download比vendor更轻量可靠，vendor主要用于离线审计，不是日常必需
最易被忽略的是：import 路径和包名分离这件事——你 import 的是模块地址，代码里调用的是包名，两者可以完全不同；而模块路径一旦写错，Go 不会提示“建议你是不是想写 xxx”，它只会冷冰冰报错，且错误信息里不包含修正线索。
