macOS 推荐 Homebrew + goenv 是因官方 .pkg 无法多版本共存、升级需重装、GOPATH 难隔离；Homebrew 解决自动更新与路径一致，goenv 提供项目级版本锁定，避免 go.mod 行为差异导致 CI 失败。

对 macOS 用户，专业开发者普遍用 Homebrew + goenv 组合；Linux 用户倾向手动解压 + GOROOT 显式配置；Windows 用户基本直接用官方 .msi 安装包 —— 这三种方式不是“谁更好”，而是各自规避了最常踩的坑。

macOS 上为什么推荐 Homebrew + goenv 而非仅用官方 pkg

官方 .pkg 安装虽然快，但升级必须重装、无法并存多版本、GOPATH 默认绑定到 $HOME/go 且难以隔离。Homebrew 解决了自动更新和路径一致性问题，而 goenv 补足了版本切换能力。

• brew install goenv 后，用 goenv install 1.21.10 和 goenv local 1.21.10 可按项目锁定 Go 版本
• 避免 go mod 因跨版本行为差异（如 go.sum 校验逻辑变更）导致 CI 失败
• goenv 不修改系统 PATH，只通过 shell hook 注入，比手动改 ~/.zshrc 更干净

Linux 下手动解压安装时，GOROOT 必须显式设置吗

必须。Linux 没有统一的包管理器默认处理 Go 路径，不设 GOROOT 会导致 go build 找不到标准库，尤其在非 /usr/local/go 路径下（比如你解压到 $HOME/sdk/go）。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

• 在 ~/.bashrc 或 /etc/profile.d/go.sh 中加两行：
  export GOROOT=$HOME/sdk/go
export PATH=$GOROOT/bin:$PATH
• 不要依赖 go 自动推导 GOROOT —— 它在某些容器或 chroot 环境下会失效
• go env GOROOT 输出应与你设置的完全一致，否则 go tool compile 可能报错 cannot find package "runtime"

Windows 上用 .msi 安装后，Path 环境变量为什么总不生效

常见原因是安装时勾选了 “Add Go to PATH for all users”，但当前用户 Shell 没有重新加载系统环境变量，或者被用户级 Path 覆盖。

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

• 打开 PowerShell，运行 $env:Path -split ';' | Select-String 'Go'，确认路径是否真实存在
• 如果返回空，说明注册表里的系统 Path 没同步进当前会话：重启终端，或运行 refreshenv（需先 choco install refreshenv）
• 避免在用户 Path 里重复添加 C:\Go\bin —— 系统级已存在时，重复条目可能导致 go 命令调用到旧版本残留二进制

真正容易被忽略的是：无论哪种安装方式，go env -w GOPROXY=https://proxy.golang.org,direct 这一步几乎必做。国内网络下不设代理，go get 和 go mod download 会卡死或超时，且错误提示极其模糊（比如只报 no required module provides package xxx，实际是连不上）。