go version报“command not found”说明path未配置：windows需检查安装时是否勾选“add go to path”或手动添加c:\go\bin；macos/linux需在~/.zshrc或~/.bashrc中添加export path=$path:/usr/local/go/bin并source，且确保go二进制有执行权限。
go version 命令输出不显示版本号，只报“command not found”
说明 go 二进制没进系统 PATH，不是安装失败，而是路径没生效。
- Windows 用户检查安装时是否勾选了 “Add Go to PATH”，没勾选就手动把
C:\Go\bin加到系统环境变量 PATH 中 - macOS/Linux 用户确认 shell 配置文件（
~/.zshrc或~/.bashrc）里写了export PATH=$PATH:/usr/local/go/bin，且执行过source ~/.zshrc - 某些终端（如 VS Code 内置终端）可能不自动加载 shell 配置，重启终端或手动 source 一次
下载的 .tar.gz 包解压后 go binary 不可执行
Linux/macOS 下常见问题：解压后的 go/bin/go 没有执行权限，或文件系统挂载时用了 noexec 选项。
- 先运行
ls -l /usr/local/go/bin/go，看权限位是否含x；不含就补上：chmod +x /usr/local/go/bin/go - 如果提示 “Permission denied” 且
mount输出里含noexec，说明该分区禁止执行二进制，得换路径解压（比如改到$HOME/go） - 别用
sudo tar解压到/usr/local后忽略所有权——确保go目录属主是你自己，否则某些工具（如go install）会拒绝写入
校验下载包完整性：为什么 sha256sum 不匹配
官方发布的每个安装包都附带 .sha256 文件，但直接比对容易出错——不是包本身被篡改，而是你下载/解压过程引入了隐式变更。
- 下载后立刻校验，别先解压再算 hash；正确流程是：
curl -O https://go.dev/dl/go1.22.5.linux-amd64.tar.gz→curl -O https://go.dev/dl/go1.22.5.linux-amd64.tar.gz.sha256→sha256sum -c go1.22.5.linux-amd64.tar.gz.sha256 - Windows 用户用 PowerShell 的
Get-FileHash，别用第三方校验工具——有些会默认按文本模式读取，导致换行符差异引发 hash 不一致 - 如果校验失败，优先重下，而不是跳过；Go 官网 HTTPS 传输可靠，失败大概率是本地网络缓存或代理污染
GOROOT 和 GOPATH 现在还必须手动设吗
Go 1.16+ 默认启用模块模式（module mode），GOPATH 不再影响依赖解析，但 GOROOT 仍需准确指向安装根目录——否则 go env GOROOT 会出错，部分工具链功能异常。
-
GOROOT通常由安装程序自动设置；手动安装时务必显式导出，例如：export GOROOT=/usr/local/go -
GOPATH可不设，Go 会 fallback 到$HOME/go；但如果自定义了GOBIN（比如想把go install生成的命令放在$HOME/bin），就得同时设GOBIN并加进 PATH - 运行
go env查看当前值，重点核对GOROOT是否为空或指向错误路径——这是多数“找不到标准库”错误的根源
gopls、gofmt）也依赖 GOROOT 下的 src 和 pkg 目录。哪怕你只写业务代码，一旦编辑器启用 LSP 或保存自动格式化，路径错一丁点就会静默失败。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
