Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
go 1.16+通常无需手动设置goroot和gopath：goroot由安装程序自动配置，gopath仅影响go install输出路径和旧项目兼容，需确保$gopath/bin在path中且保持默认值；go111module=on和goproxy（如goproxy.cn,direct）必须显式设置以保障模块行为一致与国内下载可用。
go 环境能跑起来，不等于配对了；很多看似“成功”的安装，会在 go mod download、go build 或 CI 构建时突然失败——根源几乎都出在环境变量或模块配置上。
GOROOT 和 GOPATH 到底要不要手动设？
现代 Go（1.16+）绝大多数场景下，GOROOT 完全不用动——安装程序或包管理器（如 brew install go）已自动设好，且指向正确路径（Windows 是 C:\Go，macOS 是 /usr/local/go，Linux 通常是 /usr/local/go 或 /opt/go）。强行改 GOROOT 反而容易让 go 找不到标准库。
GOPATH 在启用 Go Modules 后已退居二线，仅影响 go install 生成的二进制存放位置（即 $GOPATH/bin），以及旧式非模块项目默认源码位置。你只需确保：
- $GOPATH/bin 在系统 PATH 中（否则 go install 出的命令无法全局调用）
- 不要把它和项目目录混为一谈（项目可放在任意路径，只要 go.mod 存在）
- 推荐保持默认值：$HOME/go（Linux/macOS）或 %USERPROFILE%\go（Windows）
GO111MODULE=on 是不是必须？
是。从 Go 1.16 开始，默认值已是 on，但老机器或 Docker 镜像里仍可能为 auto 或 off，导致依赖行为不一致。
-
GO111MODULE=off：完全忽略go.mod，走 GOPATH 模式（已淘汰，易出错） -
GO111MODULE=auto：只在项目根有go.mod时启用模块——但若你在$GOPATH/src下新建项目，它会误判为传统模式 -
GO111MODULE=on：强制启用模块，无论路径在哪，行为可预测
执行 go env -w GO111MODULE=on 永久生效。别信“不用设也行”，CI 环境里没这句，go get 可能静默失败。
GOPROXY 设置不对，go mod download 就卡住
国内用户不设代理，go mod download 会卡在 proxy.golang.org（被阻断），错误常表现为：
go: downloading github.com/some/pkg v1.2.3<br>go: github.com/some/pkg@v1.2.3: reading https://proxy.golang.org/github.com/some/pkg/@v/v1.2.3.info: 404 Not Found
正确做法是立即设置国内镜像：
- 推荐组合：
go env -w GOPROXY=https://goproxy.cn,direct -
direct表示对私有模块（如公司内网 Git）绕过代理，直接拉取 - 避免用多个逗号分隔的备用地址（如
https://goproxy.cn,https://goproxy.io），Go 不支持 failover，第一个失败就终止 - 验证是否生效：
go env GOPROXY应输出你刚设的值
PATH 里漏掉 $GOROOT/bin 或 $GOPATH/bin 会怎样？
go 命令本身调用不了，或者 go install 安装的工具（如 gopls、buf、mockgen）找不到。
检查方式：which go（macOS/Linux）或 where go（Windows）必须返回有效路径；go version 能正常输出才算真正就位。
常见坑：
- PowerShell 里用
$env:PATH修改后，新终端才生效，当前会话需手动追加：$env:PATH += ";C:\Go\bin" - Linux/macOS 编辑
~/.bashrc后忘了source ~/.bashrc - VS Code 终端不读 shell 配置文件，需重启窗口或在设置里勾选 “Terminal › Integrated › Env > Os X/Linux: Use Login Shell”
最稳妥的验证链：go version → go env GOROOT GOPATH → go mod init test && go mod download —— 三步全过，环境才算稳。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
