核心是保留go.mod和go.sum，重装工具链并校准goproxy/goprivate；二者是唯一可信迁移凭证，可自动重建依赖树，避免拉错版本、静默跳过或ide报错。
迁移 Golang 开发环境，核心不是复制 $GOPATH，而是保留 go.mod 和 go.sum，再重装工具链与校准环境变量——否则 go build 会拉错版本、go mod tidy 会静默跳过冲突、IDE 会反复报 “package not found”。
go.mod + go.sum 是唯一可信迁移凭证
现代 Go 项目（Go 1.11+）的依赖状态全部由这两个文件描述。只要它们完整，go build 或 go test 就能自动还原整个依赖树，无需拷贝 $GOPATH/src、vendor/ 或旧版 Gopkg.lock。
- 只同步项目根目录下的
go.mod、go.sum和所有.go源文件（路径任意，不强制放在$GOPATH下） - 若
go.mod中含replace指向本地绝对路径（如replace example.com/lib => /home/olduser/lib），必须删掉或改用相对路径：go mod edit -replace example.com/lib=../lib - 运行
go mod download可预热$GOMODCACHE，避免首次go build卡在下载环节
GO111MODULE 不用设，但 GOPROXY 和 GOPRIVATE 必须对齐
GO111MODULE 在 Go 1.16+ 已默认为 on，手动设置反而可能干扰行为；真正影响构建一致性的，是代理和私有模块配置。
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
- 在旧机器运行
go env GOPROXY GOPRIVATE，记下输出值（如https://proxy.golang.org,direct和gitlab.example.com） - 新机器执行对应命令设置：
go env -w GOPROXY=https://proxy.golang.org,direct、go env -w GOPRIVATE=gitlab.example.com - 若公司使用私有镜像或鉴权代理，漏配
GOPRIVATE会导致go get尝试走公共代理而失败
CLI 工具不能靠 go install 重装，得按二进制分发
像 golangci-lint、dlv、migrate 这类工具，用 go install 安装时依赖本地 Go 版本和构建环境，不同机器上编译出的二进制行为可能不一致（尤其涉及 cgo 或调试符号时）。
- 优先从官方 Release 页面下载预编译二进制（如 GitHub
/releases下的golangci-lint-linux-amd64） - 统一放至
$HOME/bin并加入PATH，避免混用$GOBIN和$GOPATH/bin - 检查
which golangci-lint输出路径，确认不是指向$GOPATH/bin/golangci-lint—— 后者大概率是旧环境残留
导入路径错误常因模块名与目录结构脱节
迁移到模块模式后，import 语句必须匹配 go.mod 中声明的 module 名，且子目录名需与 import 路径最后一段严格一致。这不是约定，是构建器硬校验。
- 若
go.mod写的是module github.com/user/project，则project/utils目录下的包必须用import "github.com/user/project/utils"，不能简写为"utils"或"./utils" - 重命名项目目录后，必须同步修改
go.mod的module行，并批量替换所有import语句（可用sed -i或 IDE 的全局重命名） - 执行
go list -m all | head -5可快速验证当前模块解析是否正常，异常时会直接报错而非静默失败
最易被忽略的一点：go.sum 文件里的哈希值是绑定具体 commit 或 version 的，一旦有人手动编辑过它（比如删行、换行符），go build 会拒绝运行并提示 “checksum mismatch”。迁移时别用文本编辑器打开它，更不要“优化格式”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
