Go导入本地包必须使用模块路径而非文件路径，即go.mod中定义的module名加子目录名，如"example.com/myapp/utils"；需确保模块初始化、包声明合法且在模块根目录下操作。
Go 导入本地包必须用模块路径，不是文件路径
Go 不支持像 Python 那样用 ./utils 或 ../model 这种相对路径导入。所有 import 语句里的路径，都必须是当前模块的根路径下的子路径（即 go.mod 里定义的 module 名称 + 子目录名）。
常见错误现象：import "./utils" → local import "./utils" in non-local import；或者编译时报 no required module provides package。
- 确保项目根目录下有
go.mod文件（用go mod init example.com/myapp初始化） - 假设你的包在
utils/strutil.go，且模块名为example.com/myapp，则应写import "example.com/myapp/utils" - 如果本地包在
internal/utils，只要它属于同一模块，导入方式仍是"example.com/myapp/internal/utils"（internal仅限制外部模块访问，不影响本模块内引用）
同一模块下子目录包的导入规则
只要所有代码都在同一个 go.mod 管理的模块中，子目录天然就是可导入的包 —— 前提是目录里至少有一个 .go 文件且 package 声明合法（不能是 main，除非是主入口）。
- 目录名不强制等于包名，但建议保持一致；包名由
package xxx声明决定 -
import "example.com/myapp/utils"会加载utils/目录下所有package utils的.go文件 - 若子目录含多个
package（比如混了package utils和package helper），Go 会报错：found packages utils and helper in ...
跨目录但同模块的引用：注意 GOPATH 和 go.work 的干扰
如果你在多模块工作区（go.work）或旧式 GOPATH 下操作，本地包可能因路径解析混乱而找不到。现代 Go 推荐关闭 GOPATH 模式，纯用模块管理。
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env -w GO111MODULE=on确保模块模式开启 - 避免把项目放在
$GOPATH/src下，否则 Go 可能尝试按旧规则解析导入路径 - 检查
go list -m all是否列出你期望的模块；如果看到example.com/myapp => ./，说明本地模块已正确映射 - 若用
go.work，确认其中use包含了你的本地模块路径，例如use ./myapp
本地包未被识别？优先检查这三件事
大多数“找不到包”问题其实和语法无关，而是环境或结构没对齐。
-
go.mod中的module名是否与import路径前缀完全一致（包括大小写、域名格式）？例如模块是example.com/myapp，就不能写成example.com/MyApp - 目标目录下是否有
.go文件且package声明不为main？空目录或只有test.go（但package main）不会被当作可导入包 - 执行
go build或go run时，是否在模块根目录下运行？在子目录下运行可能导致模块发现失败
最易被忽略的一点：Go 不会自动把子目录变成包 —— 它只看 go.mod + 目录内 package 声明 + 文件存在性。少一个条件，import 就只是字符串，不是有效引用。
