go run 跑不起来90%是go命令未加入path、当前路径非模块根目录或main包缺失；需先用which go/where go验证环境，再确保go.mod存在且main.go位于正确目录。
go run 能跑起来，说明环境和代码都没问题；跑不起来，90% 是 go 命令不可用、当前路径不是模块根目录、或没写对 main 包。
command not found: go 怎么办
这是最底层的失败，VS Code 或 Goland 都救不了——IDE 只是调用你本地的 go 命令。go 不在 PATH 里，所有运行方式都会卡死。
- 终端执行
which go（macOS/Linux）或where go（Windows），看有没有输出 - 没输出？去官网下载安装包后，手动把
/usr/local/go/bin（macOS/Linux）或C:\Go\bin（Windows）加进系统PATH - 改完
PATH后，**必须新开一个终端**再试go version，别在旧终端里反复 source
cannot find package "main" 是什么情况
这个报错不是 Go 安装问题，而是作用域混乱。Go 不会自动猜你在哪个目录下想运行什么，它只认两件事：有没有 go.mod，以及当前目录下是否存在 package main 的文件。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 如果你用
go run main.go，确保该文件第一行是package main，且函数是func main()（不能带参数、不能有返回值） - 如果你用
go run .，当前目录必须有go.mod，或者至少有一个.go文件属于main包——没有go.mod时，go run .仍可工作，但多文件项目容易漏文件 - VS Code 终端默认打开在工作区根目录，但如果项目文件实际在
src/myapp/下，而你打开的是外层目录，go run .就会找不到main
Goland 里点运行按钮却报 File is invalid
这是 Goland 的 GOPATH 或运行配置没对齐导致的，不是代码问题。Goland 会按自己的规则找入口，不完全遵循命令行逻辑。
- 检查右上角运行配置里的
Working directory：它必须是你的go.mod所在目录（模块根目录），不是src子目录，也不是main.go所在目录 - 确认
GOROOT指向正确的 Go 安装路径（比如/usr/local/go），GOPATH不需要设——Go 1.16+ 默认启用 module 模式，GOPATH已退居二线 - 如果用了旧式
GOPATH/src/xxx结构，必须把整个GOPATH目录作为项目根打开，否则 Goland 会找不到包引用路径
go run 和 go build 到底选哪个
go run 是开发阶段的快捷键，go build 是交付前的必经步，两者行为差异直接影响调试节奏和错误暴露时机。
-
go run main.go：编译 + 运行一次，不生成文件，适合改一行、看一眼；但它只编译列出的文件，多文件项目容易漏 -
go run .：编译当前目录下所有.go文件（排除_test.go），推荐日常使用 -
go build -o bin/app .：生成可执行文件，能明确看到构建是否成功、二进制体积、依赖是否干净；但不会自动运行，适合 CI 或打包前验证 - 注意：
go build成功不代表能运行——比如用了cgo却没装 gcc，或调用了系统库但目标环境缺失，这些只有真正执行时才暴露
go.mod。先在终端里用 go run . 跑通，再让 IDE 对齐这个路径，比反过来调更省时间。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
