应直接安装Go官方二进制包，因其版本最新、路径固定（如/usr/local/go）、避免系统包管理器导致的GOROOT冲突、多版本混乱及代理失效问题。
初学者直接装 Go 官方二进制包，别碰 homebrew、apt 或 goenv —— 这不是“偷懒”，而是避免版本滞后、路径混乱、环境变量冲突这三类最常卡住新手的问题。
为什么官方二进制包最稳妥
macOS/Linux 用户下载 go*.tar.gz 解压到 /usr/local，Windows 用户双击 .msi 安装，路径和行为完全由 Go 团队控制。系统包管理器（如 brew install go）常滞后 1–2 个 minor 版本，且 GOROOT 和 PATH 的处理逻辑不统一，容易导致 go version 能运行但 go mod init 报错。
-
go version输出正常 ≠ 环境就绪；很多新手在brew安装后仍要手动补export PATH=$PATH:$(brew --prefix)/go/bin，而官方 MSI/.pkg 已自动完成 - 官方包解压即用，
GOROOT固定为/usr/local/go（macOS/Linux）或C:\Go（Windows），不会因 Homebrew Cellar 路径变更而失效 - Go 1.16+ 默认启用
GO111MODULE=on，无需设置GOPATH就能go mod init，老教程里强调的mkdir -p $GOPATH/src/xxx已成过时操作
PATH 配置只做一件事：让 go 命令全局可用
官方安装后，仅需确认 /usr/local/go/bin（macOS/Linux）或 C:\Go\bin（Windows）已加入 PATH。其他路径如 $GOPATH/bin 或 $(brew --prefix)/go/bin 不需要加，也不建议加 —— 初学者项目几乎不用 go install，更不需要本地 bin 目录。
- macOS/Linux：检查
echo $PATH是否含/usr/local/go/bin；若无，追加export PATH=$PATH:/usr/local/go/bin到~/.zshrc - Windows：MSI 安装器默认勾选“Add Go to PATH”，只要没取消勾选，重启终端即可
- 验证方式唯一有效：新开终端，执行
go version和go env GOROOT，二者输出路径必须一致且指向安装位置
VS Code 只装一个扩展，且必须配置代理
初学者用 VS Code 写 Go，只需安装官方扩展 Go（作者：golang），它会自动下载并管理 gopls。但国内用户不配代理，gopls 会在状态栏卡在 “loading” —— 这不是插件问题，是模块索引失败。
立即学习“go语言免费学习笔记（深入）”；
- 执行
go env -w GOPROXY=https://goproxy.cn,direct，这是唯一必需的网络配置 - 不要手动装
go-outline、go-imports等已废弃插件，它们与gopls冲突，会导致补全失效或保存时格式化崩溃 - 打开任意
.go文件后，底部状态栏显示gopls (running)才算真正就绪；若显示gopls (initializing)超过 10 秒，大概率是代理没生效
真正容易被忽略的点是：Go Modules 的初始化不依赖任何环境变量，go mod init hello 在任意空目录下都能成功 —— 但很多人卡在试图先建 $GOPATH 目录、再往里放代码，结果发现 go run main.go 报 no required module provides package。记住，模块名只是逻辑标识，不是路径约束。
