go mod init 后 gopath 不再影响依赖查找和构建，仅决定 go install 的二进制落点；module 模式下只认 go.mod 中的 require、replace 和本地相对路径，不再扫描 gopath/src。
go mod init 后 GOPATH 还管不管用
不管用。只要项目根目录下存在 go.mod 文件，Go 工具链就强制进入 module 模式，GOPATH 对依赖查找、构建、go get 下载完全失效——它只影响 go install 生成的二进制文件落点（$GOPATH/bin），以及 go get 在无模块时的老行为。
常见错误现象：go build 报错 cannot find module providing package xxx，但你明明在 $GOPATH/src/xxx 下放了代码。这是因为 module 模式下不再扫描 GOPATH/src，只认 go.mod 中的 require、replace 和本地相对路径（如 ./localpkg）。
- 运行
go list -m：成功返回模块名说明已进 module 模式；报错go: not in a module才是 GOPATH 模式 - 运行
go env GO111MODULE：输出on表示强制模块模式 -
GO111MODULE=off会彻底禁用 modules，哪怕有go.mod也视而不见——这是 CI 和协作中最容易引发“本地能跑、CI 报错”的根源
从 GOPATH 项目迁移到 Go Modules 的真实步骤
不是执行一条 go mod init 就完事。核心矛盾在于：GOPATH 项目默认把所有导入路径当成本地相对路径（比如 import "myproject/utils" 实际指向 $GOPATH/src/myproject/utils），而 modules 要求显式声明模块路径和依赖来源。
- 先用
go mod init example.com/yourname/project初始化，模块路径不能是空或纯本地名（如myproject），否则后续go get或他人引用会失败 - 原有
import语句若指向$GOPATH/src下的包，必须全部重写为模块路径（例如从"utils"改成"example.com/yourname/project/utils"） - 运行
go mod tidy自动补全依赖并清理未用项；它不会修复 import 路径错误，只会暴露缺失的 require 条目 - 如有本地子模块（如
cmd/、internal/、pkg/），确保它们在同一模块内，不额外建go.mod，否则会触发嵌套模块错误
replace 语句怎么写才生效
replace 是处理本地依赖、fork 修改、未发布版本的唯一可靠方式，但它只在当前模块的 go.mod 中起作用，且必须配合 go mod tidy 或 go build 触发重解析。
- 语法必须严格：
replace github.com/old/repo => /absolute/path/to/local/checkout，路径必须是绝对路径，不能用~/或相对路径 - 被 replace 的模块名必须与
require中声明的完全一致（包括大小写、斜杠方向），否则不匹配 - 如果本地 checkout 目录下没有
go.mod，Go 会尝试读取其module声明；若无，则 fallback 到伪版本（如v0.0.0-20260722153011-abc1234），可能导致构建失败 - CI 环境中慎用
replace：它绕过远程依赖校验，go.sum不会记录替换后的 hash，可能掩盖篡改风险
GO111MODULE=auto 的实际行为陷阱
GO111MODULE=auto 看似省心，但在混合环境里最容易出问题：它的判断逻辑依赖两个条件同时满足，稍有偏差就 fallback 到 GOPATH 模式。
- 条件一：项目根目录下存在
go.mod→ 满足则等同于on - 条件二：项目不在任何 GOPATH 的
src子目录下 → 若你把新项目放在$GOPATH/src/github.com/xxx/yyy，即使有go.mod，auto仍可能按旧规则走 GOPATH 模式 - 解决方案：统一设为
GO111MODULE=on，并在 CI 脚本开头加go env -w GO111MODULE=on，避免因开发者本地配置不一致导致行为漂移 -
go mod vendor生成的vendor/目录只在GO111MODULE=on且显式调用时才有效；auto下它可能被忽略
GO111MODULE=auto 能兜底结果掉进了 GOPATH fallback 里。这些细节不手动验证一遍，很容易在交接或部署时突然崩。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
