go version报“command not found”根本原因是path未包含$goroot/bin或终端未重载配置；需手动添加路径并source（macos/linux）或重启命令行（windows），再用which go和go version验证。
go version 命令报错或找不到，说明 PATH 没配对
安装完 go 后执行 go version 提示“command not found”或“不是内部或外部命令”，根本原因只有两个：PATH 里没加 $GOROOT/bin，或者终端没重载环境变量。
- Windows 用户装的是
.msi包，通常自动配置了GOROOT和PATH，但必须关闭并重新打开 CMD/PowerShell 才生效（旧窗口不会自动刷新） - macOS/Linux 用户如果用
.tar.gz解压安装，必须手动把/usr/local/go/bin（或你解压的实际路径）加进PATH，写入~/.zshrc或~/.bash_profile后要执行source ~/.zshrc - 检查是否生效：运行
echo $PATH看输出里有没有go/bin路径；再试which go，有返回值才算成功
go mod init 报错 “no Go files in current directory”，其实是没进对目录
新建项目后执行 go mod init example.com/hello 却报这个错，不是模块初始化失败，而是当前目录下根本没有 .go 文件 —— go mod init 并不要求必须有源码，但它会检查当前目录是否“合理”。常见踩坑点：
- 你在空文件夹里直接跑
go mod init，Go 默认接受，但后续go build或go run会因无main.go失败 - 你误在
GOPATH/src下建项目，而 Go Modules 模式下GOPATH已无关紧要，项目可以放在任意路径，只要目录里有main.go就行 - 正确做法：先创建
main.go（哪怕只写一行package main），再运行go mod init；或者直接go mod init+go run .，Go 会自动识别并提示缺失入口
go get 一直超时或报 “proxy.golang.org:443: i/o timeout”，必须换国内代理
默认的 GOPROXY=https://proxy.golang.org 在国内基本不可用，go get、go mod tidy 都会卡住甚至失败。这不是网络问题，是代理策略没改。
- 执行这三条命令（永久生效）：
go env -w GO111MODULE=ongo env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=sum.golang.org - 注意顺序：
GO111MODULE=on必须开启，否则go get仍走老式 GOPATH 模式，不走代理 - 验证是否生效：
go env | grep GOPROXY应输出你刚设的地址；go list -m -f '{{.Dir}}' golang.org/x/net能快速拉一个包测试通路 - 如果公司内网有私有仓库，加
go env -w GOPRIVATE=git.company.com，避免被代理劫持
go build 编译出的二进制文件运行报 “permission denied”，Linux/macOS 要加可执行权限
在 Linux 或 macOS 上用 go build 生成的可执行文件，默认没有 x 权限，直接 ./hello 会报错。这不是 Go 的 bug，是系统安全机制。
- 最简单：用
go run .代替，它自动编译+执行，跳过权限问题 - 如果非要生成二进制：加
-o指定输出名，比如go build -o hello .，然后chmod +x hello - Windows 不需要这步，exe 文件天生可执行
- CI/CD 构建时注意：Docker 镜像中若用
go build输出到容器内，确保目标路径有执行权限，或 COPY 后加RUN chmod +x /app/hello
go 命令能定位到代码，且能从网络拉下来。所有问题都绕不开 GO111MODULE 开关、GOPROXY 是否可用、以及当前目录是否真有可编译的 Go 文件。其他配置项如 GOPATH、GOMODCACHE 都是优化项，不是阻塞点。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
