go项目迁移至modules需先删gopkg.lock/glide.lock，再显式go mod init指定路径；gopkg.in等重定向需replace修复；默认不推荐vendor，ci须显式配置goproxy和gosumdb。
Go 项目从旧依赖管理（如 dep、glide）或非模块化状态迁移到现代 Go Modules，不是“执行一条命令就完事”的操作；不清理残留、不校验路径、不约束 GOPROXY，go mod init 很可能直接失败或生成不可靠的 go.mod。
go mod init 失败：删锁文件 + 显式指定模块路径
常见现象是执行 go mod init 后报 unknown revision 或路径不匹配错误，比如提示 module declares its path as github.com/xxx/yyy but was required as gopkg.in/xxx/yyy.v1。
根本原因在于旧工具（dep、glide）留下的 Gopkg.lock 或 glide.lock 文件仍被 go mod tidy 读取，且其中记录了分支名、提交哈希等非语义化版本。
- 先手动删除：
rm -f Gopkg.lock glide.lock - 再显式初始化：
go mod init github.com/your-org/your-repo（别用go mod init不带参数，它会瞎猜） - 若代码中 import 了
gopkg.in/yaml.v2这类重定向路径，需立即在go.mod中加replace：
replace gopkg.in/yaml.v2 => gopkg.in/yaml.v2 v2.4.0
否则后续 go build 会因路径不一致 panic。
vendor 目录要不要保留？默认不推荐
很多团队习惯性执行 go mod vendor，以为能“平滑过渡”，结果 CI 构建变慢、go run 行为异常、甚至测试因未加载 //go:embed 资源而失败。
Go Modules 的设计哲学是：依赖应通过 GOPROXY + 本地缓存分发，vendor/ 是退化选项，不是构建必需项。
- 除非 CI 环境明确禁止外网访问，且你已配置私有 proxy 和
GOSUMDB，否则不要生成vendor/ - 如果必须保留，请在
.gitignore中加/vendor，并确保所有成员禁用GO111MODULE=off -
go mod vendor后，go build默认仍走 module 模式；要强制用 vendor，必须显式加-mod=vendor参数，漏写就会行为不一致
CI 流水线卡在 go get -u：GOPROXY 和 GOSUMDB 必须显式配置
本地能跑通，CI 却频繁超时或报 checksum mismatch，基本可断定是代理和校验机制没对齐。
go get -u 在 CI 中本质是触发模块升级，而新版 Go（1.16+）默认启用 GOSUMDB 校验，若没配 GOPROXY，它会直连 GitHub，极易被阻断或限速。
- CI 脚本开头务必设置：
export GOPROXY=https://proxy.golang.org,direct export GOSUMDB=sum.golang.org
若公司有私有 proxy（如 JFrog Artifactory），替换 GOPROXY 地址即可，但 GOSUMDB 必须与 proxy 配套，不能混用 public sumdb。
漏配 GOSUMDB 可能导致模块缓存污染——某次 go mod download 下载了被篡改的包，后续构建全不可信。
GoLand 2026.1.1 启动异常：环境审计比重装更重要
装完 GoLand 打不开、弹 License 过期、调试时报 net/http: not found，90% 情况不是激活问题，而是环境隐性冲突。
尤其当你机器上同时存在多个 Go 安装（如 asdf 管理的多个版本、Homebrew 安装、手动编译版），IDE 启动时可能加载了错误的 GOROOT 或 GOBIN。
- 启动前先终端验证：
go version和which go是否指向你期望的安装路径 - 检查
$GOROOT是否被硬编码进 IDE 的idea.properties或 shell 启动脚本 - Linux Wayland 用户注意：Ubuntu 24.04 默认启用 Wayland，但若显卡驱动未更新，必须手动在
GoLand/bin/goland.vmoptions中加-Dsun.awt.X11GraphicsEnvironment=false，否则光标消失
真正卡点往往藏在 go env 输出里——比如 GOPATH 指向一个旧 workspace，而 go.mod 又在另一个目录下，IDE 就会反复尝试加载两套模块上下文，最终静默失败。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
