go mod init 仅创建 go.mod 文件，不自动使子目录可导入；import 路径必须严格匹配 module 声明与目录结构，如 go mod init example.com/myapp 后需用 import "example.com/myapp/utils"，且 utils 目录下不能有 main 函数。
go mod init 之后为什么 import 不生效？
模块初始化只是创建 go.mod 文件，并不自动让子目录变成可导入的包——Go 的 import 路径必须和 module 声明 + 目录结构严格匹配。
- 如果你执行了
go mod init example.com/myapp，那import "example.com/myapp/utils"才合法；用import "./utils"或import "utils"会报import path does not begin with hostname - 子目录下的
package utils必须放在myapp/utils/下，且该目录里不能有main函数（否则会被识别为可执行模块而非库） - 常见错误：把代码放在
$GOPATH/src下却开了GO111MODULE=on，导致 Go 完全忽略该路径，import 失败却不提示原因
go get 总是拉最新版，怎么锁死指定版本？
默认 go get github.com/gin-gonic/gin 会取最新 tag（如 v1.9.1），但生产环境需要确定性——必须显式指定版本，否则下次构建可能因上游发布新 patch 而行为突变。
- 加
@vX.Y.Z：运行go get github.com/gin-gonic/gin@v1.8.2，go.mod中会写入require github.com/gin-gonic/gin v1.8.2 - 避免用
go get -u升级全部依赖：它会跳过go.sum校验，还可能把间接依赖（// indirect）也升级，引发兼容问题 - 如果只改了
go.mod里的版本号但没运行go get，Go 不会自动下载，编译时仍用旧缓存，需手动触发同步
本地包怎么被主项目 import？用 replace 最可靠
开发中常要边改依赖边测试，比如正在调试一个 fork 的 github.com/foo/bar，但又不想改所有 import 语句——replace 就是为此设计的，不是 hack，是 Go Modules 的标准机制。
- 在
go.mod末尾加：replace github.com/foo/bar => ./local-bar
，然后import "github.com/foo/bar"就会实际加载./local-bar目录 -
replace路径支持绝对路径、相对路径、甚至另一个 Git 仓库：replace github.com/foo/bar => github.com/myfork/bar v0.1.0 - 注意：若
./local-bar目录下没有go.mod，Go 会尝试从其package声明推断模块名，容易出错；建议先在本地包里跑一次go mod init
go mod tidy 报错“no required module provides package”怎么办？
这不是网络问题，而是 import 路径和模块路径对不上——go mod tidy 会扫描所有 .go 文件里的 import，然后去 go.mod 查有没有对应 require，找不到就报这个错。
立即学习“go语言免费学习笔记（深入）”；
- 检查 import 是否拼错：比如写了
import "githib.com/xxx"（少了个 u），或大小写不符（Ginvsgin） - 确认该包是否真被引用：有些 IDE 自动生成的 import 没删干净，或条件编译（
// +build ignore）导致文件未参与构建，但tidy仍会扫描 - 临时排除干扰：加
-v参数运行go mod tidy -v，输出里会明确告诉你哪一行 import 触发了失败
go.mod 里的一行 replace 没生效，或者 import 路径里多了一个空格——这些细节不会报语法错误，但会让整个依赖链静默失效。 
