Go安装成功需依次验证：go version能输出、go run可执行hello.go、go mod init及依赖拉取正常；任一环节失败需按PATH、GOROOT、GOPATH、工具链、代理等顺序排查。
go version 能正常输出，且 go run 能执行简单程序，就说明 Golang 安装成功了——其余检查都是为了定位“为什么不能跑”或“哪里容易出错”。
运行 go version 看是否被系统识别
这是第一道门槛，也是最常卡住的地方。
如果终端报错 'go' 不是内部或外部命令（Windows）或 command not found: go（macOS/Linux），说明 go 命令根本没进 PATH。
- 检查安装路径：Windows 通常是
C:\Go\bin，macOS/Linux 一般是/usr/local/go/bin - 确认该路径已加入系统
PATH环境变量（不是只加在某次终端里，要永久生效） - Windows 用户可运行
where go，macOS/Linux 运行which go查看实际调用位置 - 若返回空或指向旧版本，说明存在多版本冲突或 PATH 配置错误
用 go env 核对关键路径是否合理
即使 go version 能跑，GOROOT 或 GOPATH 错了也会导致后续依赖拉取失败、模块初始化异常等问题。
-
go env GOROOT应指向 Go 安装根目录（如/usr/local/go），不能是/usr/local/go/bin -
go env GOPATH默认是$HOME/go，现代项目虽不强依赖它，但go install生成的二进制会放在这里的bin/下 - 若
GOROOT为空或路径不存在，Go 无法加载标准库（fmt、os等包会报cannot find package）
写个 hello.go 并 go run 验证编译链路
这一步绕不开——环境变量全对，不代表编译器和链接器能协同工作。
package main
<p>import "fmt"</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill10495" title="Bailian Usage Proxy"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20cf0281539.jpg" alt="Bailian Usage Proxy" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill10495" title="Bailian Usage Proxy">Bailian Usage Proxy</a>
<p>阿里百炼大模型平台多人共享账号用量统计代理服务。解决公司共用账号时无法区分个人用量的问题。适用场景：1)部署用量统计代理；2)统计多人Token用量和调用次数；3)管理大模型API调用配额。</p>
</div>
<a href="/xiazai/skill10495" title="Bailian Usage Proxy" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p>func main() {
fmt.Println("Hello, Go!")
}- 在任意干净目录下保存为
hello.go，然后执行go run hello.go - 成功输出即证明：源码解析、语法检查、编译、链接、运行全部通路正常
- 若报错
exec: "gcc": executable file not found（Linux/macOS），说明缺少 C 工具链（gcc或clang），某些标准库（如net）依赖它；Windows 的 MinGW 通常随安装包自带 - 不要用
go build后双击运行（尤其 Windows），而是用终端执行生成的文件，避免权限或路径问题干扰判断
测试模块功能：go mod init + 外部依赖拉取
Go 1.16+ 默认启用模块模式，若 GO111MODULE 是 off，go get 会尝试走 GOPATH 旧模式，大概率失败。
- 运行
go env GO111MODULE，如果不是on，执行go env -w GO111MODULE=on - 推荐顺手配代理加速：
go env -w GOPROXY=<a href="https://www.php.cn/link/b6512ba2ef13d7241ba28dbf20bff5a7">https://www.php.cn/link/b6512ba2ef13d7241ba28dbf20bff5a7</a> - 创建测试目录，执行：
go mod init testmod echo 'package main; import "rsc.io/quote"; import "fmt"' > main.go echo 'func main() { fmt.Println(quote.Hello()) }' >> main.go go run main.go首次运行应自动下载rsc.io/quote并输出Hello, world.；失败则大概率是网络或代理配置问题
真正容易被忽略的是：标准库不需要“安装”，它就在 $GOROOT/src 里，但如果你手动改过 GOROOT 或删过 src 目录，go run 就会静默失败——此时 go version 和 go env 都看似正常，唯独 import 报错，得靠 ls $GOROOT/src | head 实锤。
