go version命令无响应或报错说明path未正确配置：windows用.msi安装通常自动配置，mac/linux手动安装需将/usr/local/go/bin（或对应路径）添加到shell配置文件并执行source生效，windows则需重启终端。
go version 命令没反应或报错：PATH 没配对
装完 Go 后执行 go version 提示“command not found”或“无法识别命令”，基本就是 PATH 没生效。Windows 用户如果用 .msi 安装，通常自动配置；但 Mac/Linux 手动解压安装时，容易漏掉这步。
- 确认 Go 二进制路径：Linux/macOS 默认是
/usr/local/go/bin，Mac M 系列可能为/usr/local/go/bin或 Homebrew 安装在/opt/homebrew/bin - 检查当前 shell 配置文件：
~/.zshrc（新版 macOS）、~/.bashrc（旧版 Linux）或~/.profile，确保写了export PATH=$PATH:/usr/local/go/bin - 改完后必须运行
source ~/.zshrc（或对应文件），否则新开终端才生效——这是最常被跳过的一步 - Windows 用户若手动添加 PATH，请重启 CMD/PowerShell，或右键“以管理员身份运行”再试
go run main.go 报错 “package main must be declared”
这个错误不是环境问题，而是文件内容不合规。Go 要求可执行程序必须满足两个硬性条件：package main + func main()，缺一不可，且大小写、拼写、换行都不能错。
- 文件名无所谓（
main.go、hello.go都行），但内容必须以package main开头，不能是package Main或package "main" -
import语句必须紧接在package main之后，中间不能有空行（Go 1.22 允许包声明后空一行，但老版本严格要求紧邻） - 确保没有 UTF-8 BOM 头：某些编辑器（如 Notepad++）保存时会加 BOM，导致 Go 编译器解析失败，建议用 VS Code 或 Vim 保存为纯 UTF-8
- 别把代码粘贴进 Markdown 或微信里再复制——格式污染极常见，直接手敲最稳
go mod init 报错 “cannot find module providing package”
这是 Go Modules 开启后的典型依赖问题，尤其出现在首次 go run 用了第三方包（比如 github.com/gorilla/mux）却没初始化模块时。
- 先执行
go mod init example.com/myapp（模块名可以是任意合法域名或占位符，不一定要真实存在） - 再运行
go run main.go，Go 会自动补全go.mod和go.sum，并下载所需依赖 - 国内用户务必提前设置代理，否则超时失败：
go env -w GOPROXY=https://goproxy.cn,direct - 如果已有
go.mod但依赖拉不下来，试试go clean -modcache清缓存，再重试
编译出的二进制文件为什么在另一台机器上运行不了？
Go 默认静态链接，理论上跨同架构系统可直接运行，但实际踩坑点集中在 CGO 和系统库依赖上。
- 默认关闭 CGO 时（
CGO_ENABLED=0），编译出的是纯静态二进制，go build -o app main.go即可拷到任意同架构 Linux 机器运行 - 一旦用了
net/http中的 DNS 解析、或os/user等依赖系统 libc 的包，CGO 就会被隐式启用，此时必须用CGO_ENABLED=0 go build强制静态编译 - macOS 编译的二进制无法在 Linux 运行，Windows 编译的也不能在 macOS 运行——Go 不跨操作系统，需指定目标平台：
GOOS=linux GOARCH=amd64 go build - 注意：交叉编译不支持 Windows → macOS，其他组合基本都 OK
go mod init 和 CGO_ENABLED=0，新手经常等报错才想起来查，其实该作为标准动作写进项目初始化 checklist。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
