go version无响应说明PATH未包含$GOROOT/bin或GOROOT未生效，需检查并source shell配置（macOS/Linux）或修改系统环境变量（Windows），再验证echo $PATH或echo %PATH%是否含go/bin路径。
go version 命令没反应？检查 PATH 和 GOROOT 是否生效
装完 Go 后执行 go version 报 “command not found” 或直接无输出，说明 shell 没找到 go 二进制文件。这不是安装失败，而是环境变量没生效。
-
GOROOT必须指向 Go 安装根目录（如/usr/local/go或C:\Program Files\Go），且$GOROOT/bin必须加入PATH - macOS/Linux 用户注意：改完
~/.zshrc或~/.bash_profile后要运行source ~/.zshrc，否则新开终端仍不生效 - Windows 用户检查“系统属性 → 高级 → 环境变量 → 系统变量 → Path”，确认已添加
%GOROOT%\bin（不是%GOROOT%） - 验证方式：运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），看输出里是否含go/bin路径
go mod init 失败提示 “cannot determine module path”？别硬塞 GOPATH
Go 1.14+ 默认启用模块模式（GO111MODULE=on），此时 go mod init 不再依赖 GOPATH。强行把项目放在 $GOPATH/src 下反而容易触发路径推断错误。
- 新建项目时，直接在任意空目录下执行
go mod init example.com/myapp，模块名建议用域名格式，避免用main或纯数字 - 如果漏写模块名，
go mod init会尝试从当前路径推导（比如/home/user/project→project），但路径含空格、中文或以数字开头时必然失败 - 不要手动设置
GOPATH来“修复”这个问题——Go Modules 时代它已非必需；go env -w GOPATH=...反而可能干扰go install的默认行为 - 检查模块是否激活：运行
go env GO111MODULE，输出应为on；若为auto，在模块目录外执行命令可能退化为 GOPATH 模式
go get 总是超时或 403？必须配国内代理
默认代理 https://proxy.golang.org 在国内无法访问，go get 会卡住或返回 403，这不是网络问题，是代理策略导致的。
- 立即生效的配置命令：
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或go env -w GOPROXY=https://mirrors.cloud.tencent.com/go/,direct -
direct是关键后缀：表示对私有仓库（如公司内网 Git）跳过代理，直连；缺了它会导致私有模块拉取失败 - 验证代理是否起效：运行
go env GOPROXY，确认输出与设置一致；再试go get github.com/spf13/cobra@v1.8.0，几秒内应开始下载 - 不建议用
export GOPROXY=...临时设置——只对当前 shell 有效，且容易被 IDE 终端忽略；go env -w写入的是全局配置文件，VS Code、GoLand 均能识别
vscode 运行 go run 报 “exec: 'gcc': executable file not found”？那是 cgo 依赖，不是 Go 本身问题
这个错误只在代码中显式使用了 cgo（比如调用了 C 函数、用了 net 包的某些 DNS 解析逻辑）时出现，和 Go 安装无关。多数纯 Go 项目完全不需要 GCC。
立即学习“go语言免费学习笔记（深入）”；
- 先确认是否真需要 cgo：检查代码里是否有
import "C"或// #include注释；没有就不用管 - 若确实需要（如用 SQLite、OpenSSL），macOS 用户装 Xcode Command Line Tools：
xcode-select --install；Ubuntu/Debian 用户装build-essential；Windows 用户装 TDM-GCC 或 MinGW-w64 - 快速绕过：临时禁用 cgo，运行
CGO_ENABLED=0 go run main.go（Linux/macOS）或set CGO_ENABLED=0 && go run main.go（Windows） - 注意副作用：禁用后
net包会回退到纯 Go DNS 解析（可能慢），os/user等包功能受限；生产环境不建议长期关闭
GOPATH、GO111MODULE、GOPROXY 三者的状态组合判断——它们彼此不互斥，但优先级和生效条件完全不同。一个命令为什么失败，得先看它在哪个模式下运行，而不是急着重装。 
