能，但不是“一键迁移”——go mod init仅生成初始go.mod，不处理依赖版本、vendor冲突或隐式GOPATH引用；需确保模块名与导入路径一致，并注意CGO路径、vendor策略及go get版本控制等细节。
GOPATH项目能直接用go mod init升级吗
能，但不是“一键迁移”——go mod init 只生成初始 go.mod，不处理依赖版本、vendor 冲突或隐式 GOPATH 引用。
常见错误现象：import "myproject/utils" 在 GOPATH 下能编译，启用 modules 后报 cannot find module providing package myproject/utils。这是因为 GOPATH 模式下路径解析靠 $GOPATH/src，而 modules 严格按模块路径（module path）匹配。
- 先确认当前项目根目录是否含
src/子目录（典型 GOPATH 结构），如果是，cd进入真正的代码根（比如$GOPATH/src/github.com/user/repo→ 进入repo目录再执行go mod init github.com/user/repo） - 模块名必须与代码实际导入路径一致；若原项目被其他代码以
import "old-gopath-project/lib"引用，模块名就得设为old-gopath-project，哪怕它不在 GitHub 上 - 如果项目没远程地址，模块名可用伪域名如
example.com/myproj，但上线前务必替换为真实路径，否则别人go get不到
vendor 目录要不要保留
modules 默认不读 vendor，除非加 -mod=vendor 参数或设环境变量 GOFLAGS="-mod=vendor"。保留 vendor 是过渡手段，不是长期方案。
使用场景：CI 环境网络受限、或团队还没统一切到 modules，需兼容旧构建流程。
立即学习“go语言免费学习笔记（深入）”；
- 运行
go mod vendor会把所有依赖复制进vendor/，但不会自动删掉旧的vendor/中手动维护的 patch —— 那些 patch 很可能失效，因为 modules 下依赖版本由go.sum锁定，和 GOPATH 时代不同 - 若决定弃用 vendor，删掉整个
vendor/目录，并确保 CI 脚本里没有go build -mod=vendor - 注意
go list -m all显示的是 modules 解析出的依赖树，和vendor/内容可能不一致；别拿 vendor 里的go.mod当权威
go get 为什么总拉错版本
因为 GOPATH 项目通常没锁版本，go get 默认拉 latest；modules 下，go get 会更新 go.mod 并尝试满足最小版本选择（MVS），但老项目往往缺 go.sum 或有冲突约束。
常见错误现象：go get github.com/sirupsen/logrus 后，go.mod 写入 v1.9.3，但本地代码调用了 v2+ 的 WithTrace 方法，编译失败。
- 优先用
go get -u=patch升级补丁版，避免意外升主版本 - 要指定版本，写全名：
go get github.com/sirupsen/logrus@v1.8.1（注意 @ 符号不能漏） - 如果依赖本身是 v2+ 模块（路径含
/v2），导入语句必须匹配：import "github.com/sirupsen/logrus/v2"，否则 modules 会当作两个不同模块处理 -
go mod graph | grep xxx可查谁在拉哪个版本，比盲猜靠谱
CGO 和本地静态库链接出问题
modules 不改变 CGO 行为，但 GOPATH 项目常靠 CGO_LDFLAGS 硬编码 $GOPATH 下的 .a/.so 路径；切换后这些路径失效，undefined reference 就来了。
使用场景：项目依赖 C 库（如 SQLite、OpenSSL）、或用 cgo 调用自研 .h/.c 文件。
- 别在
build tags或#cgo LDFLAGS里写死$GOPATH，改用相对路径或环境变量（如${PWD}/lib） - 如果 C 头文件在
./include/，加// #cgo CFLAGS: -I./include，而不是-I$GOPATH/src/xxx/include - 交叉编译时，
CGO_ENABLED=0会跳过所有 cgo，但若代码里有import "C"且没配// +build !cgo，直接编译失败 —— 这类条件编译容易被忽略
最麻烦的其实是私有 C 依赖的路径漂移：原来放在 $GOPATH/src 下，大家靠 GOPATH 自动发现；现在得显式告诉 linker 去哪找，漏了就只能看链接器报的 ld: library not found 错误反推。
