go环境搭建需确保跨平台可复制：用官方安装包并手动配置goroot、path和goproxy（如goproxy.cn,direct），验证go version、go env goroot及path含go/bin；vscode中设go.toolsgopath而非go.gopath，项目避免在gopath/src下初始化module。
Go 环境搭建本身不难，但“可复制”意味着：同一套流程能在 Windows/macOS/Linux 上稳定复现，且新同事拉起环境后能立刻 go run、go build、go test，不卡在 GOPROXY、GOROOT 路径或 gopls 插件加载失败上。
用官方安装包 + 显式路径配置，别信“自动配置”
Windows 的 .msi、macOS 的 .pkg、Linux 的 .tar.gz 都会尝试写环境变量，但实际效果因系统版本、Shell 类型（bash/zsh/fish）、用户权限而异。尤其 macOS 14+ 和 Windows Terminal + WSL2 组合下，PATH 常漏掉 $GOROOT/bin。
- 安装后立即手动验证三件事：
go version、go env GOROOT、echo $PATH | grep go - 若
go env GOROOT输出为空或路径不对，就说明没生效，必须手动设：export GOROOT=/usr/local/go（macOS/Linux）或set GOROOT=C:\Program Files\Go（Windows CMD） - Windows 用户注意：
%GOROOT%\bin必须出现在PATH开头或显式靠前位置，否则可能被旧版 Go 或其他 bin 目录覆盖
代理必须设，且用国内双备份源
不设 GOPROXY，go get 或 go mod download 会卡在 proxy.golang.org，超时后 fallback 到 direct 模式，再尝试下载 module zip，大概率 404 —— 因为很多模块在 direct 模式下根本没公开源码地址。
- 推荐命令（任选其一）：
go env -w GOPROXY=https://goproxy.cn,direct或go env -w GOPROXY=https://mirrors.cloud.tencent.com/go/,direct - 不要只写一个源：万一
goproxy.cn临时不可用，direct会兜底，但至少保证能 fallback 到腾讯镜像 - 验证方式：
go env GOPROXY输出应含逗号分隔的两个地址，且无空格
VSCode 插件要配 go.toolsGopath，不是 go.gopath
新版 vscode-go（v0.38+）已弃用 go.gopath，改用 go.toolsGopath 控制 gopls、dlv 等工具的安装路径。设错会导致插件反复提示 “Failed to install tools”，go run 可用但调试/跳转/补全全失效。
- 打开 VSCode 设置（
Cmd+,或Ctrl+,），搜索go.toolsGopath - 填入和
go env GOPATH一致的路径，例如/Users/you/go或C:\Users\you\go - 重启 VSCode，新建
main.go，等待左下角 Go 图标从 “Loading…” 变成绿色勾选标记才算成功
go mod init 前先确认当前目录不在 GOPATH/src 下
Go 1.14+ 默认启用 module 模式，但如果你不小心在 $GOPATH/src/github.com/xxx 里执行 go mod init，会生成错误的 module path（如 github.com/xxx），后续 go get 会绕过 proxy，直接走 git clone，又回到网络问题。
- 初始化新项目前，先运行：
pwd确认不在$GOPATH/src子目录内 - 推荐做法：所有新项目都放在
~/projects/xxx这类与GOPATH无关的路径下 - module 名建议用域名或组织名，比如
go mod init example.com/myapp，避免用myapp这种裸名
真正麻烦的不是装 Go，而是不同 shell 初始化文件（~/.zshrc、~/.bash_profile、~/.profile）加载顺序不一致，导致终端里 go 可用但 VSCode 集成终端不可用。最稳的做法：所有环境变量都在 ~/.zshrc（macOS）或 %USERPROFILE%\Documents\PowerShell\Microsoft.PowerShell_profile.ps1（Windows PowerShell）里显式 export/set，并让编辑器继承该 Shell 环境。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
