goroot指向go安装目录（如/usr/local/go），path需含$goroot/bin；gopath在模块模式下仅影响go install输出和旧工具兼容，建议设为独立路径；go111module应始终设为on以避免模式混淆。
Go环境变量配置差异：GOROOT vs GOPATH vs GO111MODULE
Go 1.11 之后，GO111MODULE 成为关键分水岭——它直接决定你用的是老式 GOPATH 工作区模式，还是现代的模块（module）模式。很多人卡在“明明 go version 能跑，go run 却报错找不到包”，本质就是这三者没对齐。
常见错误现象：go: cannot find main module 或 no required module provides package，基本都是 GO111MODULE 状态和当前目录结构不匹配导致的。
-
GOROOT是 Go 安装路径（如/usr/local/go），必须指向实际 bin 目录，且PATH中要包含$GOROOT/bin；它只设一次，不随项目变 -
GOPATH在模块模式下已非必需，但某些旧工具（如go get无@version时）仍会 fallback 到$GOPATH/src；建议设为独立路径（如$HOME/go），避免和项目混在一起 -
GO111MODULE推荐始终设为on（不是auto）：避免在GOPATH内意外启用旧模式，也防止在无go.mod的子目录里被自动关闭
Windows 与 macOS/Linux 环境变量设置的实际区别
Windows 下改系统环境变量 GUI 操作容易漏掉「重启终端」或「以管理员身份运行」的问题；macOS/Linux 则常因 shell 类型（zsh vs bash）和配置文件位置（~/.zshrc vs ~/.bash_profile）导致 go env 显示值和终端实际生效值不一致。
最容易踩的坑是：在 VS Code 终端里 go version 正常，但调试器或任务运行失败——因为 VS Code 启动时读取的是登录 shell 的配置，而你可能只改了 ~/.bashrc，没同步到 ~/.zshrc（macOS Catalina+ 默认用 zsh）。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- Windows：用
setx GOROOT "C:\Go"+ 手动加%GOROOT%\bin到PATH，改完必须新开 CMD/PowerShell - macOS/Linux：统一用
echo 'export GOROOT=/usr/local/go' >> ~/.zshrc && source ~/.zshrc；验证用which go和go env GOROOT是否一致 - 别信
go env -w：它写的是go自己的缓存，不是系统环境变量，跨终端不生效
go mod init 与 GOPATH/src 目录结构的冲突点
如果你还在 $GOPATH/src/github.com/xxx/yyy 下初始化模块，go mod init 会默认把 module path 设成 github.com/xxx/yyy，但实际代码不在该路径下（比如你把项目 clone 到 ~/projects/yyy），就会导致 go build 找不到依赖或 import 路径错乱。
真实场景中，90% 的路径问题都源于这个 mismatch：module path 是逻辑标识，不是物理路径；而旧式 GOPATH 强制要求物理路径和 import path 一致。
- 正确做法：在项目根目录（任意路径）执行
go mod init myapp，然后手动编辑go.mod第一行，改成你想要的 import path（如example.com/myapp） - 绝对不要为了“符合 GOPATH 规则”而把项目硬塞进
$GOPATH/src——模块模式下它已无意义 - 如果要用相对 import（比如
import "./util"），go mod会拒绝，必须用完整 module path；这是设计使然，不是 bug
代理与校验：GOPROXY 和 GOSUMDB 不只是加速，而是可用性前提
国内直接访问 proxy.golang.org 和 sum.golang.org 基本超时，不配代理就等于没法 go get 任何非本地包。更隐蔽的问题是：即使配了 GOPROXY，若 GOSUMDB=off 而没关校验，go mod download 仍会卡住或失败。
2026 年主流配置是：GOPROXY=https://goproxy.cn,direct（fallback 到 direct 避免私有库失败），GOSUMDB=off 或 GOSUMDB=sum.golang.google.cn（后者需配对应代理）。
-
direct在GOPROXY值末尾必须显式加上，否则私有仓库（如 GitLab 内网地址）会走代理失败 - 用
go env -w GOPROXY=...设置后，检查go env GOPROXY输出是否含direct，别只看命令行回显 -
GOSUMDB=off仅限内网开发；公网项目建议用sum.golang.google.cn并确保其代理可达，否则go build可能静默跳过校验但后续部署出问题
GO111MODULE=on 后，GOPATH 的语义已经从“工作区根目录”退化为“工具缓存位置”。很多问题不是配置错了，而是默认行为变了却还按旧习惯操作。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
