go命令未识别的根本原因是path未正确配置，而非安装失败；需确认goroot/bin或gopath/bin已加入系统path，并重启终端使配置生效。
go version 命令报错或不识别
说明 go 命令根本没进系统 PATH，不是安装失败，而是路径没生效。MSI 安装包虽默认勾选“Add Go to PATH”，但若安装时权限不足、或用户账户控制（UAC）拦截，PATH 可能只写入了当前用户而非系统级变量，导致新打开的 CMD 仍找不到 go。
- 先运行
where go（Windows）或which go（Linux/macOS），看是否返回路径；没返回就确认 PATH 没包含%GOROOT%\bin或/usr/local/go/bin - 不要只改“用户变量”里的 PATH——很多旧教程漏提这点。必须检查“系统变量”中
Path是否真有%GOROOT%\bin（Windows）或/usr/local/go/bin（Linux） - 改完环境变量后，**所有已打开的 CMD/PowerShell 窗口都得关掉重开**，
source ~/.bashrc也只对当前终端生效，新开终端不会自动继承
GOPATH 设置后 go install 生成的二进制不在预期位置
go install 默认把可执行文件放进 $GOPATH/bin，但这个目录必须提前加入 PATH 才能在任意位置调用。很多人设了 GOPATH 却忘了同步加 %GOPATH%\bin（Windows）或 $GOPATH/bin（Linux/macOS）到 PATH。
- 运行
go env GOPATH确认值是你设的路径（比如D:\gopath），再手动检查该路径下是否存在bin子目录 - 如果
go install后dlv或gopls还是提示 command not found，大概率是%GOPATH%\bin没进 PATH，而不是工具没装上 - Go 1.16+ 默认启用 modules，
go get已不推荐用于安装 CLI 工具；应统一用go install golang.org/x/tools/gopls@latest，且必须确保GOPATH和PATH配套生效
国内无法 go mod download 或 go get 失败
错误信息通常是 proxy.golang.org: no such host 或 timeout，本质是模块代理不可达。Go 默认使用 https://proxy.golang.org，国内直连基本失败。
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或https://mirrors.aliyun.com/goproxy/,direct -
direct是关键：它表示对私有仓库（如公司内网 Git）不走代理，避免认证失败；逗号分隔多个代理时，Go 会按顺序尝试 - 如果项目用的是私有模块（如
git.example.com/internal/lib），还需加go env -w GOPRIVATE=git.example.com，否则 Go 仍会试图走代理查 public index
GOROOT 和 GOPATH 混用导致多版本混乱
GOROOT 指向 Go 安装根目录（含 src、pkg、bin），GOPATH 是你的工作区（含 src、pkg、bin）。两者结构相似但用途不同，强行把项目代码放 GOROOT/src 下会导致升级 Go 版本时被覆盖。
- GOROOT 应只读，不要往里放自己写的代码；常见错误是把项目建在
C:\Program Files\Go\src\myapp，结果重装 Go 就丢了 - GOPATH 可以是任意路径（如
D:\go-work），但建议避开中文、空格、符号；子目录src是传统 GOPATH 模式存放项目的地方，而 module 模式下项目可放任意位置 - 若需切换 Go 版本（如测试兼容性），别删 GOROOT；用
goenv或手动改 GOROOT 环境变量 + 重启终端即可，无需重装
go build 卡住或 go run 找不到依赖。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
