根本原因是path未生效，而非安装失败；需确认go二进制路径（如/usr/local/go/bin）已添加至shell配置文件（~/.zshrc等），并执行source或重启终端验证which go是否输出路径。
装完 Go 二进制包后，go version 还报 command not found，不是安装失败，是 PATH 没生效——这是最常卡住人的一步。
验证 go 命令是否真可用
别只信安装器勾选的“添加到 PATH”，它可能没写进 shell 配置文件，或终端没重载。
- macOS / Linux：运行
which go，没输出就说明没进PATH；检查安装路径（如/usr/local/go/bin）是否已加进~/.zshrc或~/.bash_profile - Windows：用 PowerShell 运行
Get-Command go；若失败，去「系统属性 → 高级 → 环境变量」确认Go\bin目录进了用户或系统PATH - 改完配置必须执行
source ~/.zshrc（或对应文件），或新开终端——重启终端才生效，不是“保存就立刻好”
go mod init 失败的三个隐藏原因
看似简单的一条命令，实际依赖多个前提条件，静默失败很常见。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 项目目录不能在
$GOPATH/src下：否则go mod init会尝试按旧路径推导 module 名，比如生成github.com/yourname/project变成src/github.com/yourname/project，直接出错 - 必须先清理
vendor/目录：如果旧项目留着vendor/，且GO111MODULE=off环境变量还开着，go mod init会跳过模块初始化 - 强制启用模块模式：
go env -w GO111MODULE=on，Go 1.16+ 虽默认开启，但 CI 脚本、Docker 容器或某些 IDE 插件可能仍关着
VS Code 中 gopls 启动失败怎么办
gopls 不是装上插件就自动跑起来的语言服务器，它对环境很敏感。
- 前提是
go命令本身可用：which go有输出，且go version能返回版本 - 项目根目录下必须有
go.mod：空文件夹里打开.go文件，gopls会拒绝启动；先go mod init example.com/foo - 文件后缀必须是
.go：VS Code 如果识别为其他语言（比如误标为 Plain Text），gopls不会加载 - 别手动下载
gopls二进制：VS Code 的 Go 插件会自动触发下载；若失败，检查GOPROXY是否设为国内源（如https://goproxy.cn）
国内环境下必配的三个环境变量
不配它们，go get、go mod download 会卡死或失败，尤其拉 golang.org/x/... 包时。
-
go env -w GOPROXY=https://goproxy.cn,direct：代理所有模块下载，direct表示私有模块直连 -
go env -w GOSUMDB=sum.golang.google.cn：校验和数据库也走国内镜像，避免因证书或网络问题校验失败 -
go env -w GO111MODULE=on：显式启用模块模式，防止被父进程或 shell 环境中的旧值覆盖
真正容易被忽略的，是 go mod init 执行前的路径清理和 GOPROXY 的即时生效验证——很多人反复重装 Go，其实只是没删掉 vendor/ 或没运行 source。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
