Go环境装不起来90%因GOROOT、GOPATH未配对或PATH漏$GOROOT/bin；go version报command not found是shell找不到go二进制，需确认安装路径、PATH包含对应bin目录并source配置或重启终端。
Go 环境装不起来，90% 是因为 GOROOT 和 GOPATH 没配对，或者 PATH 里漏了 $GOROOT/bin。别急着重装，先查这三处。
go version 报 command not found 怎么办
这是最常见卡点，本质是 shell 找不到 go 可执行文件。
- 确认安装路径：Windows 看安装时选的目录（比如
C:\Go），macOS/Linux 默认是/usr/local/go；用ls /usr/local/go/bin/go或dir C:\Go\bin\go.exe验证文件是否存在 - 检查
PATH：运行echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认输出里包含$GOROOT/bin或C:\Go\bin - Shell 配置未生效：macOS 用 zsh 的话，改完
~/.zshrc后必须运行source ~/.zshrc；Windows 修改环境变量后要重启终端或 CMD - 不要手动复制
go到系统 bin 目录——容易版本混乱，且go env会读错GOROOT
go env 显示 GOPATH 是 /root/go 或 /Users/xxx/go，但我想改
GOPATH 默认指向用户主目录下的 go 文件夹，它影响 go get 下载包的位置和 go build 查找本地包的路径，改它是合理需求。
- 修改方式：在 shell 配置文件中显式设置，例如
export GOPATH=$HOME/mygopath（macOS/Linux）或set GOPATH=C:\mygopath（Windows） - 注意顺序：必须在
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin之前设置GOPATH，否则$GOPATH/bin会拼错 - 验证是否生效：运行
go env GOPATH，输出应是你指定的路径；再检查$GOPATH/src是否存在，不存在就手动创建 - Go 1.13+ 默认启用 module 模式，
GOPATH对项目构建影响变小，但它仍控制go install安装二进制的位置（即$GOPATH/bin）
go run main.go 提示 cannot find package "xxx" 是路径问题还是 import 写错了
这个错误通常不是 import 语句本身写错（编译器会报更具体的 syntax error），而是 Go 工具链找不到依赖包的源码位置。
立即学习“go语言免费学习笔记（深入）”；
- 先看是否在 module 模式下：执行
go list -m，如果有输出说明当前目录在某个 module 内；没有输出则处于 GOPATH 模式 - GOPATH 模式下：被 import 的包必须放在
$GOPATH/src/xxx路径下，比如import "github.com/gin-gonic/gin"要求代码在$GOPATH/src/github.com/gin-gonic/gin/ - module 模式下：只要
go.mod里有对应依赖，go run会自动下载到$GOPATH/pkg/mod，无需手动放 src；但如果你import "./utils"这种相对路径，确保utils目录真在当前目录下 - 常见误操作：把项目直接建在
$GOPATH/src外却用 GOPATH 模式跑，或没运行go mod init myproject就直接go run
go test 报 failed: no test files 或 panic: test timed out
前者是结构问题，后者多是并发或阻塞没清理干净。
-
no test files：确认文件名是*_test.go（不是.go.txt或大小写写成TEST.go）；且文件里有函数以Test开头、参数为*testing.T -
test timed out：默认超时 10 分钟，但常因 goroutine 泄漏或 channel 死锁触发；检查是否启用了 goroutine 却没close或return，比如go func() { ch 后没读取 <code>ch - 加
-v参数看详细输出：go test -v；想跳过耗时测试可用go test -short（需在测试里用t.Short()判断） - 模糊测试（fuzz）不能和普通单元测试混在一个文件里：fuzz 函数必须是
FuzzXXX开头、参数为*testing.F，且只在go test -fuzz=.时执行
真正麻烦的不是装不上 Go，而是装上了却在 go mod 和 GOPATH 两种模式间反复横跳——一个项目用 module，另一个老项目还依赖 $GOPATH/src，这时候 go env -w 临时切换 GOPROXY 或关 module 都可能救急，但长期得统一模式。
