go version能运行不代表环境可用，真正需验证模块、代理、工具链和PATH四者对齐：GOROOT须指向含src/pkg的Go安装目录；GO111MODULE必须为on；GOPROXY应设为https://goproxy.cn,direct；$GOPATH/bin必须显式加入PATH且与go env GOPATH一致。
能跑 go version 不代表环境可用，真正要验证的是模块、代理、工具链和 PATH 四者是否对齐。
go version 能执行但 go run 报 cannot find package "fmt"
这不是代码问题，是 GOROOT 指向错误或标准库缺失。常见于：解压不完整、安装包损坏、GOROOT 被手动设错（比如指向 /usr/local/go/bin 而非 /usr/local/go）。
验证方法：
• 运行 go env GOROOT，确认输出路径下存在 src/fmt 和 pkg 目录
• 手动检查该路径是否可读：ls $GOROOT/src/fmt | head -n1
• 若为空或报 permission denied，重装 Go 或修复目录权限
go mod init 失败或 go get 卡住超时
核心原因是 GO111MODULE 未启用或 GOPROXY 不可用。Go 1.16+ 默认开启模块模式，但旧系统或手动配置可能残留 off 或 auto。
检查与修复：
• go env GO111MODULE 必须输出 on；若不是，运行 go env -w GO111MODULE=on
• go env GOPROXY 应为国内可用地址，如 https://goproxy.cn,direct；若为空或为 https://proxy.golang.org，执行 go env -w GOPROXY=https://goproxy.cn,direct
• 验证代理连通性：curl -I https://goproxy.cn，状态码应为 200
go install gopls@latest 成功但终端无法调用 gopls
说明 $GOPATH/bin 没进 PATH，或者 GOPATH 值在 shell 和 go env 中不一致。
关键排查点：
• echo $PATH 中必须包含 $GOPATH/bin 的展开路径（如 /home/you/go/bin），不能只写 $GOPATH/bin
• go env GOPATH 和 echo $GOPATH 输出必须完全一致
• 安装后新开终端再测试，旧终端不会自动加载新 PATH
• Windows 用户注意：系统变量中添加的是 %GOPATH%\bin，不是 %GOPATH%
立即学习“go语言免费学习笔记（深入）”；
IDE 提示 “Failed to start gopls” 但命令行能跑
VS Code 或 GoLand 启动失败，往往不是插件问题，而是 IDE 使用了独立的 shell 环境，没继承你配置的 PATH 或 GOROOT。
解决思路：
• 在 IDE 内置终端中运行 which gopls 和 gopls version，确认是否真能执行
• 若内置终端也不行，说明 IDE 没读取你的 shell 配置（如 ~/.zshrc）；可在 VS Code 设置里指定 "terminal.integrated.defaultProfile.linux": "zsh" 并启用 "terminal.integrated.inheritEnv": true
• 更直接的办法：在 IDE 设置中显式指定 GOROOT 和 GOPATH 路径，绕过环境变量继承问题
