Go 1.18安装需配置GOPATH以兼容老项目，并设GOPROXY为国内镜像（如阿里云）避免mod下载超时；GOROOT无需手动设置，但须确保which go与go env GOROOT/bin路径一致，否则易导致版本混乱或命令报错。
Go 环境搭建本身不难，但「装完能用」和「装完长期可维护」是两回事。绝大多数人卡在 go run 报错、go mod download 超时、或者换台电脑就跑不起来，问题往往不出在安装步骤，而在于环境变量逻辑混乱、GOPATH 与 Go Modules 混用、或代理配置被忽略。
go version 命令报错或显示旧版本
这是最常被误判为“安装失败”的现象，实际多是 PATH 或 GOROOT 冲突导致。
- Windows 下检查是否同时存在多个 Go 安装：比如
C:\Program Files\Go（MSI 安装）和D:\go（手动解压），系统可能优先读取了后者但未配%GOROOT%\bin - macOS/Linux 用户若用 Homebrew 装过旧版，再手动装新版，
which go返回的路径可能指向/opt/homebrew/bin/go，而非你新装的/usr/local/go/bin/go - 执行
go env GOROOT和which go对比，两者 bin 路径必须一致；不一致就手动清理 PATH 中冗余的 Go 路径 - 别依赖“安装包自动配环境变量”——Windows MSI 默认配了，但 macOS .pkg 不一定写入
~/.zshrc，Linux tar.gz 更是完全不配
go mod download 总是超时或连接 proxy.golang.org 失败
国内直连官方代理已基本不可用，不设 GOPROXY 就等于放弃模块拉取。
- 必须设置国内镜像代理，推荐阿里云：
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,https://proxy.golang.org,direct - 注意末尾的
,direct——它表示当镜像站没有某个包时，回退到直接拉取（避免私有模块被拦截） - 如果公司内网有自建 Nexus/Artifactory，可替换为
https://nexus.example.com/repository/golang-proxy/ - 临时关闭代理只用于调试：
go env -w GOPROXY=direct，但仅限离线开发或验证本地模块
新建项目后 go run main.go 提示 “cannot find module providing package”
这是 Go 1.11+ 启用 Modules 后的经典报错，本质是没初始化模块上下文，不是路径或 GOPATH 问题。
立即学习“go语言免费学习笔记（深入）”；
- 进入项目根目录后，第一件事必须是运行
go mod init example.com/myapp（模块名可任意，但建议符合域名格式） - 不要手动创建
GOPATH/src目录结构再把代码放进去——Modules 模式下GOPATH仅用于存放下载的依赖缓存（$GOPATH/pkg/mod），跟源码位置无关 - 若项目已有
go.mod但提示找不到包，检查当前终端是否在该文件所在目录下；go run不会向上递归查找go.mod - 误删
go.mod后，别靠复制粘贴恢复——重新go mod init+go mod tidy才能重建依赖图
VSCode 中 Go 插件提示 “Failed to install tools” 或无法跳转定义
VSCode 的 golang.go 插件默认尝试安装 gopls、dlv 等工具，但它们受 GOPROXY 和网络影响极大。
- 先在终端中手动运行
go install golang.org/x/tools/gopls@latest，看是否成功；失败则说明代理或权限有问题 - VSCode 设置里搜索
go.toolsEnvVars，添加："GOPROXY": "https://mirrors.aliyun.com/goproxy/" - Mac M1/M2 用户若遇到
gopls崩溃，确认安装的是darwin-arm64版本 Go，且插件未强制使用 x86 工具链 - 不要勾选 “Auto-update tools”，工具更新应由开发者主动控制，避免某次升级引入不兼容变更
真正麻烦的从来不是第一次装好 Go，而是三个月后想复现一个旧项目的构建环境——那时你才会发现，当初随手写的 export GOPATH=~/go 覆盖了系统级配置，或者 go env -w 写死的代理在新网络下失效。环境变量一旦写进 shell 配置文件，就得像代码一样做版本管理。
