Go模块初始化是声明模块身份的元数据操作，仅生成go.mod文件，不下载依赖、不校验import、不生成go.sum；必须在项目根目录显式指定可解析路径（如github.com/user/project），且所有import须严格匹配该路径。
Go 模块初始化不是“让项目跑起来”的动作，而是一次性声明模块身份的元数据操作；go mod init 成功只代表 go.mod 生成了，不意味着依赖就绪、构建就通、测试就能过。
go mod init 必须在项目根目录执行且显式指定 module path
很多人卡在第一步，是因为误以为当前目录名会被自动用作模块路径，或直接在子目录里执行命令。实际上：
-
go mod init不会递归查找上层go.mod，也不会根据GOPATH或当前 Git 仓库推断路径 - 如果未传参数，它可能用当前目录名（如
myapp）生成module myapp，但这会导致后续无法被他人import—— 因为 Go 的 import 路径必须是可解析的完整路径（如github.com/user/myapp或example.com/myapp） - 模块路径一旦写入
go.mod，所有内部包的 import 语句都得匹配这个前缀；改路径 ≠ 只改一行，还要同步更新全部import行，否则go build报错import "xxx" is a program, not an importable package - 本地练习可用
example.com/myproject，但别用myproject这类裸名，否则go list -m显示为空或报错
go.mod 文件生成后并不自动加载依赖或校验代码
go mod init 只写两行：module xxx 和 go yyy。它不做任何扫描、不读 .go 文件、不检查 import 是否合法。常见误解和后果：
- 即使
main.go里写了import "github.com/gorilla/mux"，go.mod里也不会出现require条目——要等首次go build或go run main.go才触发自动写入 - 若代码里有拼错的 import（比如
import "githib.com/xxx"），go mod init完全不报错；错误会延迟到go build阶段才暴露为cannot find module providing package githib.com/xxx -
go.sum文件此时为空；它只在真正下载并校验依赖包哈希后才生成，不是init的产物 - 运行
go list -m能确认模块是否被识别，但go list -m all会失败（因为还没 resolve 依赖），这是正常现象
init() 函数和 go mod init 完全无关，混用会引发隐蔽问题
新手常把包级 func init() 当成“模块启动入口”，试图在里面做配置加载或 DB 连接，结果导致测试失败、服务启动卡死、CI 构建不可复现。关键区别：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
-
go mod init是构建期命令，影响go.mod和依赖解析逻辑；init()是运行期函数，在main()前由 Go 运行时自动调用，每个包最多执行一次 -
init()中调用os.Getenv或读文件，会让单元测试无法控制输入；若它 panic，整个程序立即退出，堆栈里没有业务调用上下文，难定位 - 第三方包（如
_ "github.com/lib/pq"）依赖init()注册驱动，但你自己写的业务逻辑不该走这条路；连接 DB、加载 config、启动 HTTP server 等，必须放在main()或显式初始化函数中 - 多个
init()在同一包内按文件名字典序执行；不同包之间按 import 依赖图顺序执行——这种隐式顺序极易被重构破坏
验证模块是否真正生效的三个实操信号
别只看 go.mod 是否存在，以下任一不满足，说明模块没真正接管项目：
- 执行
go list -m输出应为你的模块路径（如example.com/myproject），而不是command-line-arguments - 执行
go build后，go.mod中应出现require条目（哪怕只有标准库伪版本），go.sum应有哈希记录 - 在项目外新建目录，写一个
main.go并import "example.com/myproject"，然后go run main.go能成功编译——这说明模块路径可被外部引用，不是本地玩具
最常被忽略的是第三点：模块路径设计是否面向未来共享，而非仅满足当前构建。一旦路径定下，改起来成本远高于初始化时多打几个字符。
