Go环境核心只需go命令可用、go.mod可生成、go run可执行，其余均为增强；90%问题源于PATH未正确配置、GO111MODULE未启用或GOPROXY未设国内镜像。
Go 环境根本不需要“搭建”成传统 IDE 那样复杂的东西，只要 go 命令能跑、go.mod 能生、go run 能出结果，就算通了。其余全是锦上添花。
go command not found？先盯死 PATH
这是 90% 新手卡住的第一关：明明安装包点完了，终端里却报 command not found。本质不是没装，而是 shell 找不到 go 可执行文件。
- macOS/Linux：运行
which go，没输出就说明 PATH 没生效；检查安装路径（比如/usr/local/go/bin）是否写进了~/.zshrc或~/.bash_profile的PATH里 - Windows：用 PowerShell 运行
Get-Command go，失败就去「系统属性 → 高级 → 环境变量」确认C:\Program Files\Go\bin（或你自定义的GOROOT\bin）已加进用户或系统 PATH - 别信安装器勾选的“添加到 PATH”——它只改注册表或 plist，新开终端才读取；要么重启终端，要么手动
source ~/.zshrc
go mod init 失败？清掉 vendor 和 GOPATH/src 干扰
go mod init 不是万能钥匙，它会在旧项目结构下静默失效或生成错误 module 名，尤其当你还在 $GOPATH/src 下建项目时。
- 删掉项目根目录下的
vendor/目录（除非你明确要锁定依赖） - 运行
go env -w GO111MODULE=on强制启用模块模式（Go 1.16+ 默认开启，但 CI 或老脚本可能关着） - 切到任意非
$GOPATH/src的路径新建项目，比如~/projects/hello，再go mod init hello - 如果已有
GO111MODULE=off环境变量，用go env -u GO111MODULE清除
本地编译失败？go build 的默认行为容易被忽略
go build 默认只在当前目录生成可执行文件，不递归处理子包，也不自动处理 main 函数缺失问题。
立即学习“go语言免费学习笔记（深入）”；
- 确保当前目录有且仅有一个
package main的.go文件，或包含func main() - 想编译整个模块（含子命令），用
go build ./...（注意...是三个点） - 跨平台编译需显式设环境变量：
GOOS=linux GOARCH=amd64 go build，否则默认编译当前系统可执行文件 -
go build -o myapp指定输出名，避免和源文件同名导致覆盖或误删
VS Code 的 gopls 启动失败？它根本不认插件开关
gopls 是语言服务器，不是靠 VS Code 插件开关控制的——它只认三件事：go 命令可用、当前目录有 go.mod、文件后缀是 .go。
- 打开项目前，先在终端 cd 进项目根目录，确认
go version和go mod graph | head -n3都能跑通 - 如果
go.mod是空的或只有module xxx，gopls可能不加载；至少加一行go 1.21（或你用的版本）让它识别为有效模块 - VS Code 设置里关掉
"go.useLanguageServer": false这类手动禁用项，让插件自动接管 - 重启 VS Code 时，看右下角状态栏有没有
gopls正在加载的提示；没有就说明没触发，大概率是前面某步断了
真正麻烦的从来不是装 Go，而是不同项目对 GO111MODULE、GOPROXY、GOOS 的隐式依赖混在一起，一不留神就编译出错、提示消失、依赖拉不到。每次新建项目，先 go env -w GO111MODULE=on 和 go env -w GOPROXY=https://goproxy.cn,direct，比反复查文档快得多。
