正确执行 go mod init 需在项目根目录运行 go mod init example.com/myproject，模块路径须与未来 import 路径一致，不可含本地路径；生成后需确保所有 import 以该路径开头，再执行 go build -o /dev/null . 和 go mod tidy。
直接在项目根目录运行 go mod init 即可初始化模块，但必须确保当前路径是你要作为模块根的目录，且 go.mod 生成后模块路径（module path）不能随意改动，否则会引发依赖解析失败。
如何正确执行 go mod init
命令本质是创建 go.mod 文件并声明模块路径。模块路径通常应与代码未来被引用的导入路径一致（例如 GitHub 地址），否则其他项目 import 时会找不到。
- 进入你的项目根目录（不是
src或cmd子目录） - 运行
go mod init example.com/myproject，其中example.com/myproject是你期望的模块路径 - 如果省略参数，
go会尝试从当前目录名或父级go.mod推断，但结果常不可靠，不建议依赖 - 模块路径中不要包含本地路径（如
/home/user/project）或 Windows 盘符（如C:\project），否则其他机器无法复现
go.mod 生成后为什么 go build 还报错找不到包？
常见原因是模块路径和实际 import 路径不匹配。比如你在代码里写了 import "github.com/you/repo/utils"，但 go mod init 用的是 go mod init myapp，那么 Go 会认为 github.com/you/repo/utils 是外部模块，而不是本项目子目录。
- 检查所有
import语句，确认它们是否都以你声明的 module path 开头（如import "example.com/myproject/utils"） - 如果项目已有历史 import 路径（如基于 GOPATH 的旧路径），需批量替换或重构导入路径
-
go list -m all可查看当前解析出的模块列表，确认本项目是否以预期路径出现在第一行
初始化后要不要立即 go mod tidy？
要，但得清楚它干了什么：它会自动添加缺失的依赖、删除未使用的依赖，并下载对应版本到 go.sum。但前提是你的代码能被 go list 正确解析 —— 也就是所有 import 必须合法、路径可定位。
立即学习“go语言免费学习笔记（深入）”；
- 先确保
main.go或其他入口文件能通过go build -o /dev/null .编译（不生成二进制，只做类型检查） - 再运行
go mod tidy；如果报错，大概率是 import 路径错误或文件不在GOOS/GOARCH匹配的构建约束下 -
go mod tidy会修改go.mod和go.sum，建议初始化后立即提交这俩文件
go mod init example.com/myproject go build -o /dev/null . go mod tidy
模块路径一旦写入 go.mod 就不该轻易改 —— 不只是影响本地构建，还会破坏所有已依赖它的下游项目。如果真要改，必须同步更新所有 import 语句，并通知所有协作者。这是最常被低估的兼容性边界。
