go mod init 报错“cannot find module providing package”主因是路径非法：项目位于 $gopath/src 下、含空格/中文，或模块名未用合法域名格式；应移出 gopath、用 go mod init example.com/myapp、删 vendor/ 再试。
go mod init 为什么总报错“cannot find module providing package”
初始化模块时，go mod init 本身不检查依赖，但它会尝试从当前路径推导模块名；如果目录在 $GOPATH/src 下或路径含非法字符（比如空格、中文），Go 会拒绝生成 go.mod，并提示类似错误。
- 确保项目不在
$GOPATH/src内——现在推荐放在任意干净路径，如~/projects/myapp - 模块名别用本地路径，写成有意义的域名形式，比如
go mod init example.com/myapp，哪怕没真注册该域名 - 如果已有
vendor/目录，先删掉再 init，否则 Go 可能误判为 legacy 模式 - Windows 用户注意：CMD 中反斜杠
\会被当成转义符，一律用正斜杠或双反斜杠
go get 后依赖没进 go.mod？或者进了但代码里 still can’t import
go get 默认只下载并缓存包，不会自动写入 go.mod，除非你明确告诉它要“添加依赖”。而且，import 路径必须和模块定义完全一致——大小写、版本号、子模块路径都不能差一点。
- 加依赖要用
go get -d github.com/sirupsen/logrus@v1.9.3（-d表示只下载不构建）或直接go get github.com/sirupsen/logrus（Go 1.16+ 默认启用-d） - 导入语句必须和
go.mod里声明的模块路径一致：github.com/sirupsen/logrus不能写成github.com/Sirupsen/logrus（旧版拼写已弃用） - 如果
go.mod里出现require github.com/xxx v0.0.0-00010101000000-000000000000这种伪版本，说明 Go 找不到 tag 或 commit，此时应指定具体 commit 或打 tag
go mod tidy 为什么删掉我手动加的 require？或者反复增删同一行
go mod tidy 的作用是让 go.mod 和实际 import 语句对齐：有 import 就加 require，没 import 就删 require。它不管你是手改还是脚本加的——只要代码里没引用，就会被干掉。
- 检查所有
.go文件是否真的 import 了那个包；注意_导入（如import _ "net/http/pprof"）也算引用，会保留 - 如果依赖只在测试文件（
*_test.go）中使用，go mod tidy默认不处理，需加-t参数：go mod tidy -t - 多模块项目中，子模块的
go.mod不会被父模块的tidy影响，每个模块得单独 tidy - 编辑器（如 VS Code + gopls）有时会后台触发 tidy，导致你刚改完就被覆盖，可临时关掉设置里的 “Run 'go mod tidy' on save”
升级依赖时 go get -u 和 go get -u=patch 有什么区别
go get -u 会升级到**主版本号相同但最新的次版本/修订版本**，比如从 v1.2.3 升到 v1.8.0；而 go get -u=patch 只升修订号（即 v1.2.3 → v1.2.9），更保守。
- 生产环境建议优先用
go get -u=patch，避免次版本升级引入不兼容变更（哪怕官方说 v1 兼容，也常有行为差异） -
go get -u不会跨主版本（比如不从 v1 升到 v2），但若依赖链里有v2+incompatible包，可能意外拉入破坏性更新 - 想精确控制，直接指定版本：
go get github.com/gorilla/mux@v1.8.0，Go 会自动 resolve 并更新go.sum - 升级后务必跑
go test ./...，有些包的 patch 版本会悄悄改日志格式或 panic 行为
模块路径不是 Git 地址，也不是文件路径，它是逻辑标识符；go.mod 里写的每一行 require，都得能在代码里被 import 到，少一个字母都不行。很多人卡在这一步，不是不会命令，是没意识到 Go 对路径一致性有多较真。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
