go环境迁移需安装匹配go版本、保留go.mod/go.sum、重装cli工具、配置goproxy/goprivate等环境变量，而非复制$gopath；replace路径需改为相对或删除，go111module无需手动设置。
Go 环境迁移到新电脑，不是复制粘贴 $GOPATH 就完事——现代 Go 项目依赖模块（go.mod）、缓存（$GOMODCACHE）、工具链（golangci-lint、dlv 等）和环境变量协同工作。直接拷贝旧目录常导致 go build 失败、go mod tidy 拉错版本、IDE 识别异常等问题。
确认 Go 版本并安装匹配的二进制
新机器必须安装与原环境**兼容或更新**的 Go 版本（建议 ≥1.16），否则 go mod 行为不一致，甚至无法解析 go.sum。
- 在旧机器运行：
go version，记下输出（如go version go1.21.6 linux/amd64） - 去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载**同版本**的预编译包（Linux/macOS 用
.tar.gz，Windows 用.msi） - 安装后验证：
go version
输出应与旧机一致 - ⚠️ 不要依赖系统包管理器（如
apt install golang）安装——版本往往滞后且路径混乱
迁移项目代码 + go.mod + go.sum（仅此三项足够）
Go Modules 项目是自描述的：只要保留 go.mod 和 go.sum，go build 或 go run 会自动下载所有依赖。不需要拷贝 $GOPATH/src 或 vendor/（除非你明确启用了 GO111MODULE=off）。
- 把整个项目目录（含
go.mod、go.sum、源码）用scp、rsync或 Git 拉到新机器任意路径（比如~/myproject） - 进入目录后直接运行：
go mod download
（可选，用于预热缓存） - 再运行：
go build
或go test，观察是否报错 - ❌ 常见错误：
cannot find module providing package xxx→ 检查go.mod中的replace是否指向本地绝对路径（如replace example.com/lib => /home/user/lib），需改为相对路径或删掉，改用go mod edit -replace
恢复常用 CLI 工具链（避免逐个 go install）
像 golangci-lint、dlv、wire、migrate 这些工具，通常通过 go install 安装到 $GOBIN。若未设置 GOBIN，它们会落在 $GOPATH/bin ——但这个路径在新环境可能为空或错位。
立即学习“go语言免费学习笔记（深入）”；
- 在旧机器执行：
go list -f '{{.Path}} {{.Dir}}' -m all | grep -v 'std\|golang.org' | head -10（粗略查看常用模块） - 更可靠的方式：查旧环境的
go env GOBIN和which列表：ls $(go env GOBIN)/golangci-lint $(go env GOBIN)/dlv $(go env GOBIN)/wire 2>/dev/null
- 在新机器统一安装（推荐用脚本）：
go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.57.2 go install github.com/go-delve/delve/cmd/dlv@latest go install github.com/google/wire/cmd/wire@latest go install github.com/golang-migrate/migrate/v4/cmd/migrate@latest
- ✅ 验证：
golangci-lint --version、dlv version等
设置关键环境变量（尤其代理与私有模块）
国内用户不设 GOPROXY，go get 会卡死；私有仓库没配 GOPRIVATE，则模块拉取失败或跳过校验。
- 在新机器运行：
go env -w GOPROXY=https://goproxy.cn,direct go env -w GOSUMDB=sum.golang.google.cn go env -w GOPRIVATE=gitlab.company.com,github.com/myorg/private
- 如果旧环境用过
~/.netrc访问私有 Git（如 GitHub Enterprise），记得同步该文件 - ⚠️ 不要设置
GO111MODULE=on——Go 1.16+ 默认开启，显式设置反而可能干扰某些 CI 场景 - 检查是否残留
export GOPATH=...：现代项目几乎不需要它，除非你仍用dep或维护极老代码
迁移真正复杂的地方不在命令本身，而在于环境变量的隐式依赖和模块路径的硬编码替换。很多人卡在 replace 指向旧路径、GOPROXY 没开、或误以为要拷贝整个 $GOPATH/pkg ——其实只要 go.mod 正确，一切都能重建。
