go环境搭建需先确认系统架构、选对安装方式、明确项目路径；macos/linux/windows需分别验证cpu类型与版本，安装包自动配path而压缩包需手动配置，go111module=on已默认启用，gopath仅存工具二进制。
Go 环境搭建本身不复杂，但跳过准备环节，后续大概率会卡在 go version 报错、go mod init 失败或 IDE 找不到 gopls 这类问题上。核心准备就三件事：确认系统信息、选对安装方式、提前想好项目放哪。
确认操作系统和 CPU 架构
别凭感觉选包——哪怕你用的是新 MacBook Pro，也得实锤是 darwin/arm64 还是 darwin/amd64；Linux 用户更要小心，arm64 服务器和 amd64 笔记本混用安装包会导致 exec format error。
- macOS：终端执行
uname -m（输出arm64或x86_64） +sw_vers（确认 macOS 版本） - Linux：用
uname -m和cat /etc/os-release，别只看“Ubuntu”就下amd64包，树莓派或 AWS Graviton 实例默认是aarch64 - Windows：命令提示符运行
echo %PROCESSOR_ARCHITECTURE%，输出AMD64不代表一定是 x86_64，部分 Surface 设备可能返回ARM64
决定用安装包还是压缩包
Windows/macOS 用户优先选 .msi 或 .pkg 安装包——它会自动把 /usr/local/go/bin（或 C:\Program Files\Go\bin）加进 PATH；Linux 用户基本只能用 .tar.gz 压缩包，手动解压 + 配环境变量是必选项。
- 安装包省事，但路径固定（比如 Windows 默认装到
C:\Program Files\Go），如果已有旧版本残留，先where go或which go确认旧路径再卸载 - 压缩包灵活，可自定义安装位置（如
$HOME/sdk/go），但必须手动追加export PATH=$PATH:/path/to/go/bin到 shell 配置文件，且要source ~/.zshrc（不是~/.bashrc，macOS Catalina 后默认用 zsh） - 别混用：已用安装包装过，又解压覆盖
/usr/local/go，容易导致GOROOT指向混乱，go env GOROOT会输出错误路径
明确项目存放位置和模块管理方式
2026 年起，GO111MODULE=on 是默认行为，GOPATH 仅用于存放 go install 的二进制工具（如 gopls、dlv），不再约束项目代码位置。但你得提前想清楚：
- 项目是否需要发布到 GitHub？那
go mod init github.com/yourname/project的域名前缀就得和实际仓库一致，否则后期改go.mod会触发依赖路径重写 - 是否离线开发？提前配置代理：
go env -w GOPROXY=https://goproxy.cn,direct（国内）或go env -w GOPROXY=https://proxy.golang.org,direct（海外），避免go get卡住 - 是否多人协作？确保团队统一用
go version go1.23+（当前稳定版），低版本可能不兼容新标准库的io或net/http行为
真正容易被忽略的点是 shell 配置文件的加载时机——改完 ~/.zshrc 后新开终端才生效，VS Code 终端可能仍读取旧环境，此时直接关掉窗口重开，别硬试 source。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
