使用 go mod init 初始化 Go Module 时，应确保模块路径与代码托管地址一致（如 github.com/yourname/project），避免在 GOPATH 内初始化或路径不匹配导致依赖异常；初始化后检查 go.mod 中 module 路径和 Go 版本是否正确，并通过编写简单 main.go 执行 go build 和 go list -m 验证模块状态，确保后续依赖管理正常。
直接用 go mod init 就能初始化一个 Go Module 工程，关键是要选对模块路径、避免常见陷阱，比如本地依赖误判或版本混乱。
选择合适的模块路径
模块路径通常是你的代码将来被他人引用时的导入路径，建议与代码托管地址一致（如 github），但不强制要求可访问。
- 如果项目将托管在
github.com/yourname/project，就运行：go mod init github.com/yourname/project - 如果是内部项目或暂无远程地址，可用域名占位，例如：
go mod init example.com/myapp - 路径中不要包含
go.mod所在目录的相对名（比如别写成./myapp）
初始化后立即检查 go.mod 内容
生成的 go.mod 文件会记录模块路径和 Go 版本。确认它符合预期：
- 第一行是
module <path></path>，路径应与你传给go mod init的一致 - 第二行类似
go 1.21，表示该模块默认使用的 Go 版本（影响泛型、切片操作等行为） - 此时还没有
require项——只有在首次go get或自动导入第三方包时才会添加
避免常见初始化错误
这些情况会导致后续依赖管理异常，初始化时就能避开：
立即学习“go语言免费学习笔记（深入）”；
- 在已有 GOPATH/src 下初始化：Go 可能沿用旧逻辑，建议新建空目录再 init
- 模块路径和实际 import 路径不一致：比如
go mod init myproj，但代码里写了import "github.com/you/myproj"，会导致构建失败 - 未设
GO111MODULE=on且当前在 GOPATH 中：可能静默退回到 GOPATH 模式，建议显式启用：export GO111MODULE=on（linux/macOS）或set GO111MODULE=on（windows）
初始化后快速验证是否正常
写个最简 main.go 并尝试构建，是最直接的验证方式：
- 创建
main.go，内容为：
package main func main() { println("hello module") }
- 运行
go build—— 成功生成二进制即说明模块已就绪 - 运行
go list -m查看当前模块名，确认和go.mod一致
基本上就这些。初始化本身不复杂，但路径选错或环境没清干净，后面加依赖、升级版本时容易卡住。