Go 在 Windows 上推荐用 .msi 安装包一键安装，自动配置 GOROOT 和 PATH；安装后须关闭所有终端并重开，再执行 go version 验证，输出版本信息即成功，无需手动设环境变量。

go 环境在 Windows 上用 .msi 安装包一步到位，不用手动配环境变量——但安装完必须关掉所有 CMD/PowerShell 窗口再重开，否则 go version 会报“不是内部或外部命令”。

Windows 下直接双击安装，别选 .zip

新手唯一推荐路径：去 https://www.php.cn/link/c3367c02da318284045c5b13c76a79d2 下载 goX.X.X.windows-amd64.msi（2026 年最新版是 go1.25.0）。.msi 会自动写入 GOROOT 和 PATH；.zip 是绿色版，得自己解压、建 GOROOT、改系统变量——零基础极易出错。

• 安装时路径可自定义，比如改成 D:\Go，但别带中文或空格
• 默认勾选项全留着，尤其“Add go to PATH”必须打勾
• 点 Finish 后，立刻关掉所有已打开的终端窗口（包括 VS Code 内置终端）

验证前先重开终端，再跑 go version

很多人卡在这步：安装完直接在原来开着的 CMD 里输 go version，提示“'go' 不是内部或外部命令”，其实是旧终端没加载新环境变量。不是安装失败，只是变量没刷新。

• 重新打开一个干净的 CMD 或 PowerShell
• 执行 go version，应输出类似 go version go1.25.0 windows/amd64
• 顺手跑 go env GOPATH，确认路径是 C:\Users\你的用户名\go（Win 默认值）

必须配国内代理，否则 go mod download 几乎必失败

Go 默认从 proxy.golang.org 拉包，国内直连超时率极高，表现为 go run main.go 卡住、go get 报 timeout 或 no matching versions。

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

• 在新终端中一次性执行这三行（永久生效）：
  go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct
go env -w GOSUMDB=sum.golang.org
• 验证是否生效：go env | findstr GOPROXY 应返回 GOPROXY=https://goproxy.cn,direct
• 不用科学上网，也不用额外装工具，这个镜像由七牛云维护，稳定可用

第一个项目不用管 GOPATH，直接 go mod init

Go 1.16+ 已废弃强制 GOPATH 项目结构，你现在可以在任何文件夹下初始化模块，比如桌面新建 hello 文件夹，进进去就干：

立即学习“go语言免费学习笔记（深入）”；

• 执行 go mod init hello（模块名随便起，不一定要和文件夹同名）
• 新建 main.go，写上 package main + func main() { println("Hello, Go!") }
• 运行 go run main.go，看到输出就说明整个链路通了

别纠结 GOPATH/src 目录结构，那是 2018 年的老习惯，现在 go mod 才是默认工作方式，也是你将来写微服务、CLI 工具的真实起点。