推荐使用 gvm 或 goenv 管理多版本 Go，避免手动解压安装包和配置 GOROOT、PATH；可轻松切换 Go 1.21 与 Go 1.23，防止与 apt/brew 等系统包管理器冲突。
Go 语言环境现在不需要手动下载安装包、配置 GOROOT、折腾 PATH，主流方案已转向版本管理器 + 模块原生支持的组合，直接跳过传统坑。
用 gvm 或 goenv 管理多版本，别碰系统级安装
Linux/macOS 上手动解压 Go 安装包再改 shell 配置，容易和系统包管理器（如 apt、brew）冲突，升级时还可能覆盖或丢失 GOROOT。实际项目中常需切换 Go 1.21 和 Go 1.23 —— 这种需求靠改环境变量太脆弱。
-
gvm（推荐 macOS/Linux）：执行bash 后，<code>gvm install go1.23即可隔离安装 -
goenv（更轻量，兼容 CI）：通过git clone https://github.com/goenv/goenv.git ~/.goenv安装，goenv install 1.21.10后用goenv local 1.21.10锁定当前目录版本 - Windows 用户建议用
gvm-win或直接使用 Scoop：scoop install go，它会自动处理PATH且支持scoop reset go回滚
go mod 是默认模式，别再写 GO111MODULE=on
Go 1.16+ 已强制启用模块模式，GO111MODULE 环境变量在绝大多数场景下完全多余。设它反而可能掩盖路径问题，比如误把 $GOPATH/src 当作模块根目录。
- 新建项目只需
go mod init example.com/myapp，无需提前建src目录 - 依赖自动下载到
go.sum并缓存至$GOPATH/pkg/mod，不是项目内vendor/ - 若遇到
cannot find module providing package，先确认当前目录有go.mod，再检查 import 路径是否拼错（比如误写成github.com/user/repo/v2却没发布 v2 tag）
VS Code + gopls 的配置关键点
官方语言服务器 gopls 默认行为有时会卡在“Loading…”或跳转失效，根源常是工作区未识别为模块根目录，或启用了错误的 Go 版本。
立即学习“go语言免费学习笔记（深入）”；
- 确保打开的是包含
go.mod的文件夹，不是其子目录（否则gopls无法定位模块） - 在 VS Code 设置里关闭
go.useLanguageServer的手动开关，让它由gopls自动管理 - 如果提示
gopls requires a Go version >= 1.20，说明 VS Code 读取的是系统 PATH 中旧版 Go —— 用goenv local 1.23或修改 VS Code 的"go.gopath"设置指向正确版本的bin目录
真正麻烦的从来不是装 Go，而是不同项目对 Go 版本、模块路径、编辑器索引的隐式依赖。把版本交给 goenv、把依赖交给 go mod、把编辑体验交给 gopls 的默认约定，比任何手调配置都可靠。
