必须显式指定模块路径，因为Go工具链依赖模块路径解析import语句、校验依赖完整性、支持go get拉取及他人引用；若省略参数，自动推导的路径（如myproject）常与实际仓库地址不一致，导致import失败、私有库拉取异常、go list -m结果不符等问题。
直接初始化就能用，但不设模块路径或忽略 go.mod 位置，后续 import 和构建会出错。
为什么 go mod init 必须带模块路径？
Go 工具链靠模块路径解析 import 语句，比如你写 import "github.com/yourname/project/internal/handler"，工具必须知道当前模块是不是 github.com/yourname/project。如果只运行 go mod init 不带参数，它会按当前目录名生成路径（如 myproject），但这个路径和实际仓库地址不一致，会导致：
- 私有库拉取失败（
go get找不到对应域名） - 其他项目引用你时 import 路径对不上
-
go list -m显示的模块名和预期不符
所以推荐始终显式指定： go mod init github.com/yourname/myproject（路径需与代码托管地址一致）。
go mod init 后依赖没自动加进 go.mod？
它只生成空的 go.mod 文件，不会扫描现有代码。依赖是在首次执行 go build、go run 或 go get 时才被发现并写入的。常见现象：
- 刚 init 完就
go run main.go，报错cannot find module providing package ...—— 因为还没下载依赖 - 手动
go get github.com/gin-gonic/gin后，go.mod才出现require github.com/gin-gonic/gin v1.9.1 - 如果已有
import但没运行任何命令，go.mod里依然为空
GO111MODULE=auto 时 init 失败的典型场景
当项目目录在 $GOPATH/src 下，且 GO111MODULE=auto（默认值），go mod init 会静默失败，不生成 go.mod，也不报错。验证方式：
- 执行
go env GO111MODULE看当前值 - 检查
go.mod是否真的存在（别只信终端输出） - 临时强制开启：
GO111MODULE=on go mod init example.com/foo
长期建议在 shell 配置中设为 on，避免环境差异引发问题。
go.sum 为什么第一次 go run 才生成？
go.sum 记录的是所有依赖模块的校验和，它依赖实际下载的包内容。初始化时没下载任何依赖，自然没有校验数据。只有当你真正触发依赖解析（如 go run 或 go mod tidy）后，Go 才会：
- 从
GOPROXY拉取模块 zip 包 - 计算其
h1:前缀哈希值 - 连同版本写入
go.sum
注意：go.sum 不是“可选文件”，CI 构建、多人协作都依赖它做完整性校验；删掉它再跑 go build 会重新生成，但可能因代理或网络变化导致哈希不一致而报错。
最容易被忽略的是模块路径与代码仓库 URL 的一致性——它不只影响别人怎么引你，还决定 go get 能不能正确路由到你的私有 Git 服务器或代理源。
