重装系统或换电脑后，Go开发环境可复用旧配置：保留GOROOT、GOPATH及go.mod结构，重点迁移$GOPATH/pkg/mod缓存；需手动安装Go二进制并统一路径，VS Code中显式配置goroot/gopath，且确保gopls重装与项目有go.mod。
重装系统或换电脑后，Go 开发环境不用从头摸索——只要保留 GOROOT、GOPATH 和 go.mod 目录结构，90% 的配置可直接复用。
确认旧环境的 Go 安装路径和模块缓存位置
迁移前必须搞清两个关键路径：Go 二进制所在位置（GOROOT），以及模块下载缓存和工作区（GOPATH 下的 pkg/mod 和 src）。很多人只备份项目代码，却丢了 $GOPATH/pkg/mod，结果重装后 go build 又要重新下载所有依赖，耗时且可能因网络波动失败。
- 在旧机器上运行
go env GOROOT和go env GOPATH，记下输出路径（如/usr/local/go和/home/user/go） - 检查
$GOPATH/pkg/mod是否存在且非空——这是模块缓存的根目录，建议整个pkg文件夹一起拷贝 - 如果用的是 Go 1.16+ 且项目启用
GO111MODULE=on（默认），src下的内容其实已非必需，但私有仓库 fork 的代码若放在这里，仍需保留
新系统安装 Go 时绕过包管理器直装二进制
Linux/macOS 上用 apt install golang 或 brew install go 看似方便，实则埋坑：系统包管理器常滞后于官方版本，且会把 GOROOT 绑定到 /usr/lib/go 或 /opt/homebrew/Cellar/go，与你旧环境路径不一致，导致 go env -w GOROOT=... 后部分工具（如 dlv、gopls）识别异常。
- 去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载对应平台的
go1.x.x.linux-amd64.tar.gz或go1.x.x.darwin-arm64.tar.gz - 解压到固定路径，例如
sudo tar -C /usr/local -xzf go.tar.gz，确保新GOROOT和旧的一致 - 在 shell 配置中显式设置：
export GOROOT=/usr/local/go和export GOPATH=$HOME/go（路径需与旧环境完全相同）
复用模块缓存时注意 vendor 和 checksum 差异
直接把旧 $GOPATH/pkg/mod 拷到新机器，不代表 go build 就能秒过。Go 在首次使用缓存模块时会校验 go.sum，若旧缓存里某模块被篡改过（比如手动 patch 过）、或本地 go.sum 记录了不同校验值，构建会报 checksum mismatch 错误。
立即学习“go语言免费学习笔记（深入）”；
- 先运行
go mod download，让 Go 用新环境重新生成缓存索引；再把旧pkg/mod中的cache/download子目录（含 .info/.mod/.zip 文件）覆盖进去，这样既省下载又保校验 - 如果项目启用了
vendor，别忘了同步vendor/目录本身——它不依赖GOPATH，但路径必须和go mod vendor生成时一致 - 遇到
sum: missing hash，不要盲目删go.sum，先试go mod tidy -v看具体哪个模块缺失，再针对性go get -u
VS Code + gopls 配置继承的关键变量
编辑器里写代码卡顿、跳转失效，大概率不是 Go 安装问题，而是 gopls 没读对 GOPATH 或模块根目录。VS Code 的 Go 扩展默认会读取系统环境变量，但如果你在终端里 export 过，而 VS Code 是从桌面图标启动的，它根本看不到这些变量。
- 在 VS Code 设置中搜
go.goroot和go.gopath，填入和终端里go env输出完全一致的路径（注意结尾不要斜杠） - 确保项目根目录下有
go.work或go.mod——gopls依赖这个识别模块边界，否则会扫描整个GOPATH/src，巨慢 - 如果之前用过
go install golang.org/x/tools/gopls@latest，迁移后记得重装：go install golang.org/x/tools/gopls@latest，否则语言服务器版本可能不兼容新 Go
最易被忽略的是 shell 配置文件加载时机和 VS Code 启动方式的错位——哪怕所有路径都对，只要编辑器没拿到正确的环境变量，gopls 就会静默退化成基础语法提示。动手前先在 VS Code 集成终端里敲 go env | grep -E "(GOROOT|GOPATH)"，眼见为实。
