报错“go.mod file not found”是因项目未初始化模块，需在main.go所在根目录执行go mod init example.com/myapp；go 1.16+默认启用模块模式但严格依赖go.mod文件，无此文件则拒绝解析import，即使go version正常也会报错。
go.mod file not found 是模块没初始化，不是环境坏了
报这个错，说明 Go 已经装好、go version 能正常输出，但项目还没“告诉” Go 它要走模块模式。Go 1.16+ 默认启用模块（GO111MODULE=on），可它只认 go.mod 文件——没有就拒绝解析任何 import，连 go run main.go 都会失败。
这不是网络问题、代理问题，也不是 GOPATH 路径旧账，纯粹是项目根目录下缺一个 go.mod。
- 必须在
main.go所在的最外层文件夹里执行命令，pwd看一眼当前路径，ls go.mod应该能看见文件 - 模块名不能是空、
.、test或中文，推荐用go mod init myapp（本地练手）或go mod init example.com/myapp（语义清晰，兼容后续发布） - 执行后生成
go.mod和空的go.sum，此时再go run main.go才真正开始解析 import
no required module provides package 是依赖没声明，不是包写错了
比如报 no required module provides package github.com/cloudwego/hertz/pkg/app，表面看是包路径不对，实际是 Go 根本没把那个包“纳入管理范围”——因为模块没初始化，或者初始化了但没把依赖写进 go.mod。
go mod init 只建骨架，不拉依赖；go run 时发现 import 的包不在 go.mod 里，就直接拒掉。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 先确认
go.mod存在且你在正确目录下 - 运行
go mod tidy：它会扫描所有import，自动添加缺失依赖、删掉未用包，并更新go.sum - 如果
go mod tidy卡住或报 timeout，说明代理没设好，执行go env -w GOPROXY=https://goproxy.cn,direct - 别手动
go get xxx—— 容易版本不一致，go mod tidy才是权威同步方式
GO111MODULE=auto 导致 go.mod 被无视
设成 auto 时，Go 会检查当前路径是否在 $GOPATH/src 下：如果是，就退回到 GOPATH 模式，直接忽略 go.mod，哪怕它就在你眼皮底下。
结果就是：文件存在、命令能跑、但依赖全不认——典型“有文件却不用”。
- 查当前值：
go env GO111MODULE，输出应为on - 强制开启：
go env -w GO111MODULE=on - 顺手检查
$GOPATH路径，避免把项目建在$GOPATH/src/xxx里；移到~/projects/xxx更干净 - IDE（如 Goland）可能绕过你的
go.mod，关掉 Settings → Go → Go Modules → “Enable Go modules integration”
go mod tidy 后仍找不到包，重点查这三处
go mod tidy 成功执行后还报包不存在，大概率不是模块问题，而是代码或路径本身有硬伤。
- 检查 import 路径拼写：比如
github.com/gin-gonic/gin写成github.com/gin-gonic/ginn或大小写错误（Go 区分大小写） - 确认代码中真用了那个包：如果
import "github.com/xx/yy"但整段代码里没出现yy.Xxx()，Go 会认为这是“未使用导入”，go mod tidy会把它删掉 - 排除
vendor干扰：如果项目里有vendor/目录且GO111MODULE=on，Go 默认不读 vendor；想用 vendor 就得设GO111MODULE=off或go mod vendor重新生成，但不推荐
最常被忽略的是工作目录和模块名合法性——go mod init 看似一步到位，但路径错、名字乱、环境变量漂移，都会让后续所有操作失效。动手前先 pwd 和 go env GO111MODULE 看一眼，比反复重试快得多。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
