go mod init 必须手动指定真实模块路径，如 github.com/username/project，否则自动推导易出错导致 import 失败；初始化前需清理目录，且模块路径必须与所有 import 语句完全匹配。
go mod init 必须指定模块路径，不能空着或乱填
不指定参数直接运行 go mod init，Go 会尝试从当前路径推导模块名，比如你在 ~/code/github.com/user/project 下执行，它可能猜出 github.com/user/project；但若路径是 ~/dev/myapp，它大概率生成 myapp 这种本地名——这会导致后续所有 import 失败，因为 Go 工具链找不到对应模块。
- 推荐始终手动指定：用未来真实托管地址（如
github.com/username/project），哪怕还没 push 上去 - 私有项目可用公司内网域名（如
git.internal.company/backend），并配好GOPRIVATE - 绝对不要用
./project、../mylib或带空格/特殊字符的路径——Go 不支持 - 模块路径一旦写进
go.mod，改它就得同步改所有import语句，代价极高
初始化前目录必须“干净”，否则 go.mod 会漏依赖或误判
如果目录里混着旧的 vendor/、Gopkg.lock、甚至编译好的二进制，go mod init 不报错，但扫描 .go 文件时可能跳过某些包，导致后续 go build 报 cannot find module for path xxx。
- 执行前先清理：
rm -rf vendor/ Gopkg.lock go.sum go.mod - 确保只留源码文件（
.go）和 README 等非构建文件 - 已有
go.mod？删掉再 init，别指望覆盖——Go 会直接报go.mod already exists - 子目录（如
cmd/、internal/）不用单独 init，一个项目根目录一个go.mod就够了
go mod init 不下载依赖，真正干活的是 go mod tidy
go mod init github.com/xxx/app 只生成两行的 go.mod：module github.com/xxx/app 和 go 1.22。此时代码里写了 import "golang.org/x/sync/errgroup"，直接 go run . 会失败，提示缺失校验和——这不是 bug，是设计如此。
- 依赖分析和填充由
go mod tidy触发：它扫描全部.go文件，补require、删未用项、生成go.sum - CI/CD 中务必把
go mod tidy当作初始化必走步骤，光 init 不算完 - 想预加载所有依赖？用
go mod download，不是反复跑 init - Go 版本号由 init 自动设为当前
go version主版本（如 1.22），小版本（1.22.3）不写进go.mod
模块路径必须匹配 import 路径，否则本地包都导不进去
假设你执行了 go mod init example.com/mytool，但代码里写的是 import "mytool/utils"，Go 会报 cannot find module providing package mytool/utils——因为工具链只认 example.com/mytool/utils 这个完整路径。
- 所有
import语句必须以模块路径开头，比如import "example.com/mytool/utils" - 即使项目纯本地开发，也要按这个规则写 import，否则
go build和 IDE 都会失灵 - 路径大小写敏感：GitHub 仓库是
MyProject，模块路径就不能写成myproject，否则go get拉错版本 - 私有 Git 地址要和模块路径对齐，比如
git@gitlab.example.com/group/proj对应模块路径gitlab.example.com/group/proj
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
