推荐下载官网MSI安装器，自动配置GOROOT和PATH；避免中文/空格路径；安装后重启终端执行go version验证；Go 1.16+默认启用模块模式，无需手动设置GOPATH。
下载并安装 Go 安装包（注意版本与架构）
直接去官网 https://go.dev/dl/ 下载 Windows 版本的 MSI 安装器，优先选 go1.xx.x.windows-amd64.msi（64 位系统）或 go1.xx.x.windows-386.msi（32 位，已极少见）。MSI 安装器会自动配置 GOROOT 和添加 go.exe 到系统 PATH，省去手动设置环境变量的麻烦。
常见错误：下载 ZIP 包后解压，但忘记手动配置 GOROOT 和 PATH，导致命令行输入 go version 报 “不是内部或外部命令”。
- 安装时勾选 “Add go to PATH”（默认已勾选），否则需手动把
C:\Go\bin加入系统 PATH - 不要把 Go 安装到含中文或空格的路径（如
C:\Program Files\Go），某些旧版工具链可能解析失败 - 安装完成后重启终端（CMD / PowerShell / VS Code 终端），再执行
go version验证
验证 GOPATH 是否需要手动设置（Go 1.16+ 默认启用 module）
从 Go 1.16 开始，GO111MODULE=on 成为默认行为，模块模式（module）已取代 $GOPATH/src 的传统工作区结构。绝大多数新项目无需手动设置 GOPATH，也不必把代码放在 %GOPATH%\src 下。
只有以下情况才需关注 GOPATH：
立即学习“go语言免费学习笔记（深入）”；
- 维护非常老的 Go 项目（
- 想自定义
go install编译出的二进制存放位置（默认是%GOPATH%\bin） - 某些 IDE（如旧版 Goland）仍依赖
GOPATH索引，但现代版本已支持 module-aware 模式
若确实要设，建议用 PowerShell 设置用户级变量（不影响系统全局）：
Set-ItemProperty -Path 'HKCU:\Environment' -Name 'GOPATH' -Value 'C:\Users\YourName\go'
然后重启终端生效。不推荐改系统级 GOPATH，容易和多版本 Go 冲突。
配置代理加速模块下载（国内必须做）
不配代理时，go mod download 或 go get 会卡在 proxy.golang.org，超时失败。Windows 上最稳妥的方式是设置环境变量：
- 打开 “系统属性 → 高级 → 环境变量”，在“用户变量”中新建：
GO111MODULE=onGOPROXY=https://goproxy.cn,direct - 或者用 PowerShell 一次性设置（仅当前会话）：
$env:GO111MODULE="on"$env:GOPROXY="https://goproxy.cn,direct"
注意：goproxy.cn 是国内可用、镜像完整、更新及时的公开代理；direct 表示对私有域名（如公司内网模块）直连，避免误代理。
验证方式：新建一个空目录，运行
go mod init example.com/hello<br>go get github.com/gin-gonic/gin@v1.9.1，看是否能快速拉取依赖。
VS Code 中正确启用 Go 扩展（不是装完就完事）
装了 Go 扩展（由 Go Team 官方维护）只是第一步。它依赖本地 go 命令和一系列 LSP 工具（如 gopls），而这些工具默认会在首次打开 .go 文件时自动安装——但国内网络下大概率失败。
手动安装关键工具更可靠：
- 确保已配置
GOPROXY（见上一节） - 打开 VS Code 终端（Ctrl+`），运行：
go install golang.org/x/tools/gopls@latest<br>go install github.com/go-delve/delve/cmd/dlv@latest
- 在 VS Code 设置中搜索
go.toolsManagement.autoUpdate，设为true，后续工具升级更省心
如果打开 .go 文件后仍提示 “The Go language server is not available”，检查 gopls 是否真在 %GOPATH%\bin 或 %PATH% 中可执行（运行 gopls version）。别忽略这个步骤，很多“代码没提示”“跳转失效”的问题根源都在这儿。
真正麻烦的不是安装，而是每个环节的隐性依赖：PATH 是否生效、代理是否覆盖所有子命令、编辑器是否用了正确的 go 环境（尤其当你装了多个 Go 版本时）。建议每配一步，都用对应命令当场验证，别堆到最后一起查。
