go命令未被识别需先检查PATH配置：macOS/Linux用户确认$HOME/sdk/go/bin是否加入PATH，Windows用户检查安装时是否勾选“Add Go to PATH”或手动添加Go\bin；验证用which go或Get-Command go，无输出则需优先修复PATH问题。
检查 go 命令是否在系统 PATH 中
如果终端输入 go 报 command not found，说明安装包没正确配置环境变量，或安装过程被跳过。macOS/Linux 用户常见于未将 $HOME/sdk/go/bin（或自定义解压路径下的 bin）加入 $PATH；Windows 用户则需确认安装向导是否勾选了「Add Go to PATH」，或手动把 Go\bin 目录加进系统环境变量。
验证方式：
which go # 或 Windows PowerShell 中： Get-Command go
若无输出，就别急着查版本——先解决命令不可用的问题。
运行 go version 看输出是否合法
go version 是最轻量的安装验证动作，它不依赖 GOPATH 或模块初始化，只读取二进制自身嵌入的版本信息。正常输出类似：
立即学习“go语言免费学习笔记（深入）”；
go version go1.22.3 darwin/arm64
注意以下异常情况：
-
go: command not found→ PATH 问题（见上一节） -
go version devel go1.23-xxxxx→ 你装的是开发版，不是正式发布版，但功能完整 -
panic: invalid stack map或段错误 → 极可能是架构不匹配（比如在 Apple Silicon 上运行了 x86_64 编译的 Go 二进制）
用 go run 执行一个最小 main.go
版本号能打印，不代表编译器和运行时真正就绪。真实项目会用到标准库、链接器、CGO（如有）、模块缓存等组件，所以必须跑一次实际代码。
新建文件 main.go：
package main
<p>import "fmt"</p><p>func main() {
fmt.Println("Hello, Go!")
}然后执行：
go run main.go
成功输出 Hello, Go! 才算闭环。常见失败点：
-
build cache is required, but could not be located→GOCACHE被设为空或不可写，删掉该环境变量或重设为有效路径即可 -
cannot find package "fmt"→ 安装包损坏，建议彻底删除GOROOT目录后重装官方二进制 -
exec: "gcc": executable file not found→ 非必需，但某些标准库（如net）在 CGO_ENABLED=1 时会触发，macOS 需装 Xcode Command Line Tools，Linux 需装build-essential或对应 gcc 工具链
检查 go env 中关键变量是否合理
go env 显示当前 Go 环境配置，重点看三项：
-
GOROOT：应指向你安装 Go 的根目录（如/usr/local/go），不能是空或乱路径 -
GOBIN：通常为空，表示使用$GOROOT/bin；若设了值，要确保该目录在PATH中 -
GOPATH：Go 1.16+ 默认启用 module 模式，GOPATH不再强制要求，但若设了，需确保其bin子目录可写（否则go install会失败）
顺手跑一遍：
go env GOROOT GOPATH GOBIN比扫全量输出更高效。如果
GOROOT 和你实际安装路径不符，大概率是多个 Go 版本共存时 shell 初始化脚本加载了旧的 PATH。 
