直接原因是当前目录缺少go.mod文件，Go工具链拒绝模块模式构建；解决方法是在项目根目录执行go mod init example.com/myproject生成go.mod文件。
go run 时提示 “go.mod file not found” 怎么办
直接原因是当前目录没有 go.mod，Go 工具链拒绝以模块模式构建。VSCode 的 Go 扩展（比如调试器或运行任务）默认启用模块模式，不会退回到旧的 GOPATH 模式。
解决方式很简单：在项目根目录终端里执行
go mod init example.com/myproject
其中 example.com/myproject 是你的模块路径，可以是任意合法域名格式（不一定要真实存在），只要全局唯一、能反映项目归属即可。执行后会生成 go.mod 和空的 go.sum。
常见错误：
- 在子目录下执行
go mod init，导致模块路径与实际代码结构错位 - 把项目放在
$GOPATH/src下还试图用模块模式——应移出 GOPATH - 误删了
go.mod后只改了代码，没重新运行go mod init或go mod tidy
修改代码后运行结果不变，是不是 go.mod 没更新？
不是。运行结果不变和 go.mod 是否更新无关，而是编译缓存或进程未重启造成的假象。
go run 每次都会重新编译，但以下情况会导致你“看不到变化”：
- VSCode 调试器没重启——旧二进制还在跑，改完代码没点「重新启动」
- 终端里手动执行了
go build但忘了运行生成的可执行文件，还在双击/调用旧的./xxx - 代码里有 panic 或逻辑分支没走到，误以为“没生效”
go.mod 只影响依赖解析和构建环境，不影响单文件逻辑执行。它不会“缓存运行结果”。
go mod tidy 不自动添加新 import 的包？
会，但前提是 import 语句已写进代码且保存了文件，并且你执行的是 go mod tidy（不是 go mod download 或 go get）。
典型流程：
- 在
main.go里加一行import "github.com/sirupsen/logrus" - 保存文件
- 终端执行
go mod tidy→ 自动下载依赖、写入go.mod和go.sum
容易踩的坑：
- VSCode 自动保存关掉了，改完 import 没手动保存，
go mod tidy就看不到新 import - import 路径拼写错误（比如少个
v2），go mod tidy会报错退出，不会静默忽略 - 用了 replace 或 exclude，但没同步更新
go.sum，导致后续构建失败
go.mod 版本冲突时 VSCode 还能正常运行吗？
能运行，但可能在构建阶段失败，或者运行时 panic。VSCode 本身不校验版本兼容性，它只是调用 go build 或 go run；真正出问题的是 Go 编译器和链接器。
比如你 import 了一个函数，但它在依赖的某个版本里已被删除，go run 会直接报 undefined: xxx。这时候看 go.mod 里的版本号没用，得查实际生效版本：
go list -m all | grep some-package
再配合 go mod graph 看谁拉进了这个版本。别只盯着 go.mod 文件里写的版本——MVS 算法可能选了更高或更低的版本。
最常被忽略的一点：VSCode 的语言服务器（gopls）缓存的依赖信息可能滞后。改完 go.mod 后，最好手动触发一次 go mod tidy，然后在 VSCode 里按 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows/Linux），输入 “Go: Restart Language Server”。
