go version命令报错说明path未包含go的bin目录：windows需检查系统级path是否含%goroot%\bin，macos/linux需确认~/.zshrc中export path=$path:$goroot/bin且goroot已定义。
go version 命令报错或返回空，说明环境变量没配对
常见现象是打开终端就输 go version，提示 'go' is not recognized as an internal or external command（Windows）或 command not found: go（macOS/Linux）。根本原因是 PATH 没包含 Go 的 bin 目录。
检查安装路径是否被正确加入 PATH：
- Windows：确认
%GOROOT%\bin（如C:\Go\bin）已添加到系统环境变量Path中；不要只加到用户变量里，CMD 默认读系统变量 - macOS/Linux：在
~/.zshrc或~/.bash_profile中确保有export PATH=$PATH:$GOROOT/bin，且$GOROOT已正确定义（如export GOROOT=/usr/local/go） - 验证方式：执行
echo $PATH（macOS/Linux）或echo %PATH%（Windows CMD），看输出里有没有go的bin路径
go mod init 后 go build 失败，大概率是 GOPROXY 没生效
新建项目后运行 go mod init example.com/hello，再 go build 却卡住、超时，或报错 cannot load ...: module ...: Get ...: dial tcp: i/o timeout，基本就是模块代理没起作用。
国内用户必须显式设置 GOPROXY：
- 临时生效（当前终端有效）：
go env -w GOPROXY=https://goproxy.cn,direct - 永久生效后，新开终端仍需验证：
go env | grep GOPROXY，输出应为GOPROXY="https://goproxy.cn,direct" - 别用
https://proxy.golang.org—— 这个地址在国内基本不可达，即使设置了也等同于没设 - 如果用了私有仓库，
direct部分不能省，否则内部模块会走代理失败
go build 生成的可执行文件名不按预期，关键看调用方式
go build 默认行为容易混淆：它不总生成 main.exe 或 a.out，名字取决于你传什么参数、当前目录下是否有 go.mod、以及 main 包里有几个 main() 函数。
三种常用写法的区别：
-
go build main.go→ 输出文件名固定为main.exe（Windows）或main（macOS/Linux），无视go.mod名称 -
go build（当前目录含go.mod）→ 输出文件名取自go.mod第一行的 module 名，比如module example.com/api就生成api或api.exe -
go build -o app→ 强制指定输出名，跨平台统一为app（Linux/macOS）或app.exe（Windows）
注意：如果目录下有多个 *.go 文件但没有 main.go，或者 package main 里没定义 func main()，go build 会直接报错，不是静默失败。
go run 和 go build 的本质区别，不只是“快不快”
go run main.go 看似方便，但它每次都会重新编译并执行，不保留中间产物；而 go build 是生成可独立运行的二进制文件。两者底层调用的编译器相同，但行为边界很明确。
实际使用中要注意：
-
go run只能运行单个main包文件，不能带子命令或 flag 解析逻辑复杂时调试不便（比如go run main.go --port=8080要求main.go本身处理 flag） -
go build后得到的二进制可复制到无 Go 环境的机器上直接运行，go run则完全依赖本地go工具链 - CI/CD 流程里必须用
go build，go run只适合本地快速验证 - 若项目含 cgo 代码，
go run可能因 CGO_ENABLED 环境变量未设而失败，go build更可控
真正容易被忽略的是：当你在非模块根目录下执行 go run *.go，Go 会尝试把所有 .go 文件合并编译，但如果其中混入测试文件（*_test.go）或非 main 包文件，就会报 cannot load ...: no required module provides package —— 这不是 bug，是模块感知机制在起作用。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
