Go二进制未进PATH导致go version无输出，需重启终端或手动添加%GOROOT%\bin到系统Path；go mod init报错因目录不在GOPATH/src且未指定模块名，应运行go mod init example.com/myapp；国内拉包失败多因GOPROXY未生效，应执行go env -w GOPROXY=https://goproxy.cn,direct。
go version 命令报错或无输出
说明 Go 二进制没进 PATH，不是安装失败，而是环境变量没生效。Windows 下 .msi 安装虽自动写入 Path，但旧 CMD/PowerShell 窗口不会刷新变量。
- 必须关闭所有已打开的终端窗口，重新启动 CMD 或 PowerShell 再试
- 检查
go是否在%GOROOT%\bin目录下（默认是C:\Program Files\Go\bin） - 若仍不行，手动把该路径加到系统
Path环境变量里（注意不是用户变量） - 别用 Git Bash 验证——它不继承 Windows 系统环境变量，除非你额外配置
go mod init 报错：‘cannot determine module path’
这是新手最常卡住的地方：当前目录不在 GOPATH/src 下，又没显式指定模块名，go mod init 就不知道该叫什么。
- 执行前先确认你在项目根目录，且该目录有
main.go或其他.go文件 - 直接运行
go mod init example.com/myapp，模块名可以是任意合法域名格式（不需要真实存在） - 别用中文路径、空格路径或桌面路径——Windows 上某些符号或权限会导致
go mod初始化失败 - 如果只是临时测试，用
go run .可跳过模块初始化（Go 1.16+ 支持）
go run 和 go build 的行为差异
go run 是编译+执行，go build 只编译不执行，但两者对工作目录和包结构的依赖完全不同。
-
go run .：要求当前目录含main包，且只有一个main()函数；支持多文件，但不能有重复main包 -
go build默认生成同名可执行文件（如main.exe），加-o才能指定输出名，比如go build -o app.exe -
go build ./cmd/app：会去子目录找main包，适合多命令项目；而go run ./cmd/app也合法，但只运行那个子包 - 如果
go run提示 “no Go files in current directory”，说明没找到package main，检查文件扩展名是不是.go，内容有没有漏写package main
国内拉包超时或 get 失败：GOPROXY 没生效
go get 或 go mod download 卡住、报 timeout 或 connection refused，大概率是代理没配对或被覆盖。
立即学习“go语言免费学习笔记（深入）”；
- 执行
go env GOPROXY，输出必须是类似https://goproxy.cn,direct，而不是空或https://proxy.golang.org,direct - 如果输出不对，运行
go env -w GOPROXY=https://goproxy.cn,direct（注意逗号后不能有空格） - 某些 IDE（如 VS Code）会读取自己的 shell 环境，启动前没加载
go env设置，建议在 IDE 终端里单独执行一次go env -w - 验证是否生效：
go mod download github.com/gin-gonic/gin@v1.9.1，几秒内完成即 OK
vendor 文件夹或 GO111MODULE=off 环境变量，就会退化为老式 GOPATH 模式——这时所有依赖都得手动扔进 $GOPATH/src，现代开发中基本没人这么干。 
