go version报“不是内部或外部命令”说明path未配置，需将go的bin目录（如c:\go\bin）加入系统环境变量path；goroot设置不等于path生效，漏配path则命令不可用；goproxy必须用go env -w设置为https://goproxy.cn,direct，否则go mod download会卡死。
go version 命令报错：不是内部或外部命令
说明系统根本没找到 go 可执行文件，不是版本问题，是路径缺失。
- Windows 下安装 MSI 包后，
go默认在C:\Go\bin；若改过安装路径，就得手动把对应bin目录加进系统Path环境变量 - Linux/macOS 用 tar.gz 解压安装的，必须显式设置
GOROOT并把$GOROOT/bin加入PATH，否则go命令永远找不到 - 别只设
GOROOT就以为完事了——PATH才是让终端认出命令的关键，漏掉这步等于装了个寂寞
GOPROXY 不配，go mod download 必卡死
国内直连 proxy.golang.org 几乎不可用，不设代理就等同于放弃依赖管理。
- 推荐值：
https://goproxy.cn,direct或https://goproxy.io,direct，用逗号分隔表示“先走代理，失败再直连” - 设置命令必须用：
go env -w GOPROXY=https://goproxy.cn,direct，别用旧式 shell export，它只对当前终端生效 - 验证是否生效：
go env GOPROXY输出应为设定值；再试go mod download github.com/go-sql-driver/mysql，秒下即成功
goctl 安装失败：command not found 或符号错误
goctl 是 go-zero 生态里生成代码的命脉工具，装不上后续全瘫。
- 先清旧残留：
rm -f $GOPATH/bin/goctl（Linux/macOS）或删掉%GOPATH%\bin\goctl.exe（Windows） - 必须带环境变量安装：
GO111MODULE=on GOPROXY=https://goproxy.cn,direct go install github.com/zeromicro/go-zero/tools/goctl@latest - 确认
$GOPATH/bin在PATH里：echo $PATH | grep "$GOPATH/bin"（Linux/macOS），Windows 检查系统变量中是否含该路径 - 绝对别用
go get——Go 1.17+ 已弃用，硬用会报错或装错版本
Ubuntu 24.04 上 apt install golang 可能装太旧
官方源里的 golang 包常滞后 1–2 个 minor 版本，比如当前最新是 go1.22.2，APT 却只提供 go1.21.x。
- 开发新项目建议绕过 APT，直接去
https://golang.google.cn/dl/下载最新.linux-amd64.tar.gz - 解压到
/usr/local/go，再按标准方式配GOROOT和PATH，比 APT 更可控 - 如果坚持用 APT，务必检查：
go version输出是否满足项目最低要求（如需泛型、切片操作符等特性）
PATH、某个代理没生效、或是旧版二进制残留干扰了新安装——这些细节不手动验证，光看教程步骤永远跑不通。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
