Go环境搭建成功只需安装官方二进制包并执行go version验证：macOS/Linux解压tar.gz至/usr/local，Windows运行msi安装，默认配置PATH；输出如go version go1.26.5 darwin-arm64即表示成功。
go 环境能跑起来，就说明搭对了——初学者不需要理解 GOPATH、GOROOT 或模块路径语义，直接装官方二进制包 + 验证 go version 即可开工。
直接装官方二进制包，别碰包管理器
macOS/Linux 用户去 https://go.dev/dl/ 下载对应架构的 go*.tar.gz（比如 Apple Silicon 选 go1.26.5.darwin-arm64.tar.gz），解压到 /usr/local：sudo tar -C /usr/local -xzf go*.tar.gz
Windows 用户下载 go*.windows-amd64.msi 双击安装即可。
不推荐用 brew install go 或 apt install golang，原因很实在：
- 系统包管理器里的版本常滞后 1–2 个 minor 版本，而 Go 的工具链（如
gopls）和文档默认按最新稳定版写 - homebrew/apt 安装路径不统一（比如 brew 装在
/opt/homebrew/Cellar/go/...），容易导致go env -w GOPROXY=...失效或go run找不到gopls - 新手卡在“为什么教程里命令不生效”，90% 是因为环境变量和实际安装路径对不上
验证安装只需一条命令
打开终端（或 PowerShell），执行：go version
看到类似 go version go1.26.5 darwin-arm64 就算成功。
如果报错 command not found: go，说明 /usr/local/go/bin（macOS/Linux）或 C:\Program Files\Go\bin（Windows）没进 PATH：
- macOS/Linux：检查
echo $PATH是否含/usr/local/go/bin；没的话，在~/.zshrc或~/.bash_profile末尾加一行export PATH=$PATH:/usr/local/go/bin，再source ~/.zshrc - Windows：MSI 安装器默认已配好
PATH，若失效，手动在“系统属性 → 环境变量”中确认%GOROOT%\bin存在且未被其他 Go 路径覆盖
VS Code 只装一个插件，代理必须配
装完 VS Code 后，只安装官方扩展 Go（作者：golang），它会自动拉取并管理 gopls。
别装 go-outline、go-imports 这类已废弃插件，它们和 gopls 冲突，会导致补全失效或编辑器卡死。
国内用户打开 .go 文件后，底部状态栏若一直显示 gopls (loading)，基本就是代理问题：go env -w GOPROXY=https://goproxy.cn,direct
这条命令必须执行，否则 go mod download 和 gopls 初始化都会超时失败——不是插件坏了，是网络卡在拉依赖。
第一个程序不用管模块名和路径
任意目录下建文件夹，比如 hello，进目录后执行：go mod init hello
然后新建 main.go，内容就是：
package main<br>
import "fmt"<br>
func main() {<br>
fmt.Println("Hello, World!")<br>
}再运行：
go run main.go输出
Hello, World! 就成了。注意：
-
go mod init后面的hello只是模块标识，不是路径要求，也不必是域名；当前阶段随便起名，以后推 GitHub 再改 - 不要手动创建
$GOPATH/src目录结构——Go 1.16+ 默认开启GO111MODULE=on，GOPATH已退居二线，仅用于存放go install的二进制文件 - 删掉
go.mod和go.sum就退回到无模块状态，但没必要倒退；有模块才能用go get拉第三方包
GOROOT 导出语句，go env 看起来正常，但 gopls 启动时会静默失败。遇到奇怪问题，第一反应不是重装，而是先 go env | grep -E "(GOROOT|GOPATH|PATH)" 看输出是否干净。 
