Go module初始化后import路径必须严格匹配go.mod中module声明，如module example.com/myapp则import必须为example.com/myapp或其子路径，不支持相对路径或本地文件系统路径。
Go module 初始化后，import 路径必须匹配 go.mod 的 module 名
如果你的项目根目录下执行了 go mod init example.com/myapp，那么所有 import 语句中的路径前缀就必须是 example.com/myapp 或其子路径（如 example.com/myapp/utils），不能写成相对路径（如 ./utils）或本地文件系统路径（如 /home/user/myapp/utils）。Go 不支持 Python 那样的相对导入。
常见错误现象：import "utils" 报错 no required module provides package utils —— 这是因为 Go 不会自动从当前目录推导包路径，它只认 module 定义的根路径。
- 确保
go.mod中的module声明与实际 import 路径严格一致 - 自定义包目录需在 module 根目录下，例如
example.com/myapp/utils/stringutil.go对应 import"example.com/myapp/utils" - 不要在
import中使用./、../或绝对路径
同一 module 内部子包引用：路径基于 module 根，而非文件位置
Go 的 import 路径是逻辑路径，不是物理路径。即使 main.go 和 utils/helper.go 在同一级目录，只要 utils 是子目录且包含 package utils，它的 import 路径就由 module 名 + 目录名拼接而成。
示例结构：
立即学习“go语言免费学习笔记（深入）”；
myapp/
├── go.mod # module example.com/myapp
├── main.go # import "example.com/myapp/utils"
└── utils/
└── helper.go # package utils在 main.go 中必须写：
import "example.com/myapp/utils"，而不是
"utils" 或 "./utils"。
- 子包的
package声明名（如package utils）只影响代码内标识符访问，不影响 import 路径 - import 路径中最后一段（如
utils）只是约定俗成的别名，可被重命名：import u "example.com/myapp/utils" - 若子包路径含非法字符（如
-），Go 会拒绝构建；建议只用小写字母、数字和下划线
vendor 模式或 GOPATH 模式下 import 路径失效的典型原因
Go 1.16+ 默认关闭 GOPATH 模式，强制启用 module。如果仍遇到 “cannot find package” 错误，大概率是残留了旧模式配置：
-
GOPATH环境变量非空且项目不在$GOPATH/src/下 → Go 会尝试按 GOPATH 规则查找，失败后不 fallback 到 module - 项目根目录无
go.mod，但存在vendor/→ Go 可能启用 vendor 模式，但此时 import 路径仍需匹配 vendor 内包的 module 名（不是 vendor 目录结构） - 运行
go build时加了-mod=vendor但 vendor 中缺少对应包 → 报错cannot find module providing package ...
解决方法：清空 GOPATH（或 unset），确认有 go.mod，并用 go mod tidy 同步依赖。不要手动维护 vendor/，除非 CI 明确要求离线构建。
跨 module 引用：import 路径就是另一个 module 的 module 名
假设你开发了独立库 github.com/you/httpkit，并在其 go.mod 中声明 module github.com/you/httpkit，那么其他项目只需：
import "github.com/you/httpkit"
Go 会自动从 proxy 或源码仓库拉取该 module（除非本地用 replace 覆盖）。关键点：
- import 路径必须与目标 module 的
module声明完全一致（包括大小写和域名） - 若本地调试，可用
replace github.com/you/httpkit => ../httpkit在自己的go.mod中指向本地路径 - 不支持 import 未发布到远程或未声明 module 的本地目录（比如
import "../otherproj"永远不合法）
路径规则本质就一条：import 字符串 = module 声明字符串 + 子目录（如有）。没例外，也不模糊。容易被忽略的是，很多人改了 go.mod 的 module 名却忘了同步所有 import 语句，然后花半小时查为什么包找不到。
