Go SDK安装后go version报错或找不到命令说明系统未识别Go路径，需检查PATH是否生效、对应shell配置文件是否正确导出PATH并执行source重载；Go 1.16+虽默认启用modules，但GOPATH仍影响go install输出和部分工具；VSCode中gopls崩溃多因环境变量未继承，需确保GUI启动时加载正确配置；交叉编译必须显式设置GOOS/GOARCH及CGO_ENABLED=0（若用cgo），并验证产出文件目标平台。
Go SDK安装后go version报错或找不到命令
说明系统根本没识别到Go二进制路径，不是“装了但没配好”，而是PATH压根没生效。常见于macOS/Linux解压后只改了当前shell的~/.zshrc或~/.bash_profile，但新终端没重载、或者用的是fish/sh等其他shell。
- 先运行
which go，如果返回空，证明PATH没生效 - 确认安装路径（比如
/usr/local/go），然后检查对应shell配置文件里是否写了export PATH="/usr/local/go/bin:$PATH" - 改完配置后必须执行
source ~/.zshrc（或对应文件），不能只关掉再开终端——某些终端启动时不读配置 - Windows用户注意：修改环境变量后，已打开的CMD/PowerShell窗口不会自动更新，必须重启终端
GOPATH现在还必须手动设吗？
Go 1.16起默认启用Go modules，GOPATH对项目构建已无强制要求，但仍有两处实际影响：
-
go install命令（非模块内）生成的可执行文件，默认仍放在$GOPATH/bin，不设的话会报“cannot find module providing package”或直接失败 - 部分老工具（如某些IDE插件、旧版
gopls）仍依赖GOPATH定位缓存和源码 - 建议保留
GOPATH，设为~/go（Linux/macOS）或%USERPROFILE%\go（Windows），并把$GOPATH/bin加入PATH
VSCode里gopls反复崩溃或无法启动
本质是语言服务器没正确加载Go环境，不是插件本身问题。最常被忽略的是：gopls需要读取go env输出，而VSCode启动时可能没继承系统shell的完整环境变量。
- 在VSCode集成终端里运行
go env GOPATH和go env GOROOT，确认输出正常；如果报错，说明VSCode没拿到Go环境 - macOS用户尤其注意：GUI应用（包括VSCode）默认不加载
~/.zshrc，需在~/.zprofile里重复写一遍PATH和GOPATH导出 - Windows用户检查：VSCode是否以管理员身份运行？某些策略会拦截环境变量传递
- 临时验证法：关闭VSCode，终端里执行
code --no-sandbox --disable-gpu启动，看gopls是否恢复
跨平台编译前忘了设GOOS/GOARCH
go build默认只生成当前系统可执行文件，想编译Windows二进制却在Linux上跑go build，结果还是Linux版——没报错，但完全没达到目的。
立即学习“go语言免费学习笔记（深入）”；
- 必须显式指定：
GOOS=windows GOARCH=amd64 go build -o app.exe（Linux/macOS下） - Windows PowerShell要用
$env:GOOS="windows"，CMD用set GOOS=windows，别混用语法 - 注意CGO_ENABLED：交叉编译时若项目用了cgo（比如调SQLite、OpenSSL），
CGO_ENABLED=0才能成功，否则会提示“cross compilation not supported” - 验证产出文件：用
file app.exe（Linux/macOS）或Get-Command app.exe | % Extension（PowerShell）确认目标平台
go env输出，比事后查一小时日志更省时间。 
