直接装同版本Go，别迁移GOPATH；现代项目靠go.mod和模块缓存驱动，硬拷路径会导致依赖解析失败、IDE报错；只需同步项目目录+go.mod+go.sum，在新机重装工具链并正确配置GOROOT、GOPATH、PATH即可。
直接装同版本 Go，别碰旧 $GOPATH
迁移 Golang 环境不是复制 $GOPATH 目录——现代 Go 项目靠 go.mod 和模块缓存驱动，硬拷路径只会让 go build 找不到依赖、go mod tidy 拉错版本、IDE 报红一堆包。
- 在旧机器运行
go version，记下完整输出（如go version go1.21.6 linux/amd64） - 去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载**完全相同版本**的预编译包（Linux/macOS 用
.tar.gz，Windows 用.msi） - 安装后立刻验证：
go version输出必须一字不差；go env GOROOT应指向新安装路径（如/usr/local/go） - ⚠️ 别用
apt install golang或brew install go——系统包管理器版本滞后，且GOROOT路径常不标准，后续工具链会出问题
只同步项目目录 + go.mod + go.sum
Go Modules 项目是自描述的：有 go.mod 和 go.sum，go run 或 go build 就能自动拉取所有依赖。不需要 vendor/、不用 $GOPATH/src、更别碰 $GOMODCACHE（那是本地缓存，新机重下更快）。
- 把整个项目目录（含
go.mod、go.sum、所有.go文件）用scp、rsync或git clone拉到新机器任意路径（比如~/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 这些工具，通常装在 $GOBIN（默认是 $GOPATH/bin），但新环境这个路径可能为空、没加进 $PATH，或者 Go 1.21+ 默认不设 GOBIN，导致命令找不到。
- 在旧机器查哪些工具真在用：
go list -f '{{.Path}} {{.Dir}}' -m all | grep -v 'std\|golang.org'（粗筛） - 更准的方式是查旧环境的安装位置：
go env GOBIN和ls $(go env GOBIN) - 新机器上统一重装（以
golangci-lint为例）：go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.55.2（指定版本，避免行为漂移） - 装完确认：
export PATH=$PATH:$(go env GOPATH)/bin（Linux/macOS）或把%GOPATH%\bin加进 Windows 系统 PATH
环境变量只需配三个：GOROOT、GOPATH、PATH
GO111MODULE 不用设，默认就是 on；GOPROXY 和 GOPRIVATE 可按需补，但不是迁移必需项。重点是让 go 命令本身可用、工具能被 shell 找到。
立即学习“go语言免费学习笔记（深入）”；
- Linux/macOS：编辑
~/.zshrc或~/.bashrc，加三行：export GOROOT=/usr/local/goexport GOPATH=$HOME/goexport PATH=$PATH:$GOROOT/bin:$GOPATH/bin - Windows：系统属性 → 环境变量 → 新建
GOROOT（值如C:\Go）、GOPATH（如C:\Users\YourName\go），再把%GOROOT%\bin和%GOPATH%\bin加进PATH - 验证：
go env GOROOT GOPATH输出应非空；which golangci-lint（或where golangci-lint）应返回路径
go.mod、go.sum 和源码，其余全在新机重装。最容易被忽略的是 replace 的绝对路径残留和 GOBIN 路径未加入 PATH，这两处一卡，半天就耗在找命令和解析失败上了。 
