go version 正常不代表环境就绪，关键需配置 goroot、path、goproxy 和 go111module：goroot 指向安装根目录且 $goroot/bin 必须加入 path；goproxy 必须设为可用代理（如 https://goproxy.cn,direct）；go111module 应为 on；gomodcache 需确保权限与空间充足。

go version 能正常输出，不代表环境就 ready 了——很多开发者卡在 go run 报错、go mod init 失败、或依赖拉不下来，根源不在安装本身，而在环境变量和模块模式的协同配置。

GOROOT 和 PATH 必须显式设置（除非用 Windows 官方 MSI）

Windows 上用 .msi 安装确实会自动写入 GOROOT 和 PATH，但 macOS/Linux 手动解压后不会。漏配 $GOROOT/bin 到 PATH，会导致终端认不出 go 命令；而 GOROOT 本身不设，某些工具（如 delve 或 IDE）可能无法定位标准库源码。

• GOROOT 应指向 Go 安装根目录（如 /usr/local/go 或 /usr/local/opt/go/libexec）
• PATH 中必须包含 $GOROOT/bin，顺序无关紧要，但不能只靠 GOBIN
• 验证命令：go env GOROOT 和 which go 输出路径应一致

GOPATH 已非必需，但 GOPROXY 必须配

Go 1.11+ 默认启用 modules，GOPATH 不再控制项目位置，但 GOPROXY 直接决定 go get 和 go mod download 能否成功。国内不配代理，90% 的依赖会超时或 403。

• 推荐值：export GOPROXY=https://proxy.golang.org,direct（官方）或 https://goproxy.cn,direct（国内镜像）
• 设完立刻生效：go env -w GOPROXY=https://goproxy.cn,direct
• 注意：如果公司内网有私有代理，direct 部分不能删，否则内网模块拉不到

go mod init 后的首条命令别乱跑

新建项目执行 go mod init example.com/hello 只是生成 go.mod，此时 go run main.go 可能失败——不是语法问题，而是模块感知未激活或 GO111MODULE 状态不对。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

• 确认模块开启：go env GO111MODULE 应输出 on（Go 1.16+ 默认开启，旧版需手动 go env -w GO111MODULE=on）
• 首次 go run 会触发依赖解析，若 main.go 引用了第三方包，GOPROXY 没生效就会卡住
• 避免直接 go build ——它默认输出到当前目录，容易和源码混在一起；用 go build -o ./bin/hello 显式指定输出

go env 输出里这三项最该盯住

运行 go env 后，别扫全屏，只盯这三行：

• GOPROXY：必须是非空且可访问的地址，off 或空值等于断网
• GOPATH：现在只是历史兼容项，只要不干扰 go install 到 $GOPATH/bin 就行
• GOMODCACHE：这是模块下载缓存路径，如果磁盘空间不足或权限不对，go mod download 会静默失败

真正容易被忽略的是 GOMODCACHE 权限问题：比如用 sudo go mod download 一次，后续普通用户就没法写入缓存目录，得手动 chown 回来。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！