Go本地包导入失败主因是导入路径与目录结构不一致：import路径必须严格匹配目录路径，且需以go.mod中module声明为前缀，同目录文件自动属同一包无需import。
Go 本地包导入失败，90% 是因为导入路径和目录结构不一致，而不是包名写错了。
import 路径必须等于目录路径，不是 package 名也不是文件名
你在 main.go 里写 import "myproject/utils"，Go 就会去项目根目录（或 go.mod 所在目录）下找 utils/ 这个子目录，且该目录里至少有一个 .go 文件声明了 package utils。它完全不关心你文件叫 helper.go 还是 logic.go，也不看你 package 声明是不是拼成 utlis——只要路径对不上，就报 cannot find package。
- 错误示例：
import "myproject/utils/stringutil"，但实际只有myproject/utils/目录，没有stringutil/子目录 - 正确做法：要么新建
myproject/utils/stringutil/目录并放一个package stringutil的文件，要么把 import 改成"myproject/utils" - 包名（
package xxx）只影响你代码里怎么调用它的导出符号，比如utils.DoSomething()还是stringutil.DoSomething()
go.mod 定义了整个模块的导入前缀，不能忽略
如果你执行过 go mod init github.com/yourname/myapp，那所有本地包的导入路径都得从 github.com/yourname/myapp 开始算起。哪怕你的项目就放在 /home/user/myapp，也不能写 import "./utils" 或 import "utils" ——Go 不支持相对路径导入，这是硬性限制。
- 项目结构是：
myapp/ ├── go.mod └── utils/ └── helper.go -
go.mod内容是：module github.com/yourname/myapp - 那么
helper.go必须被import "github.com/yourname/myapp/utils"导入，而不是"utils" - 如果想简化，就把
go.mod的 module 名设为短名，比如module myapp，之后就能用import "myapp/utils"
同一目录下的多个 .go 文件共享一个包，无需互相 import
只要两个文件都在 utils/ 目录下，且都以 package utils 开头，它们就属于同一个包。你可以直接在 a.go 里调用 b.go 里定义的 func Helper()（首字母大写），或者访问 var internal = 42（小写也行），完全不需要任何 import 语句。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 这是 Go 和其他语言很不同的地方：目录即包边界，同目录即同空间
- 常见误操作：给同目录文件加
import "."或试图用import "./a"，Go 会直接报错 - 小写字母开头的标识符（如
doInternal()）只能被同包文件访问，对外不可见 —— 这是 Go 唯一的访问控制机制
go build / go run 时找不到包，先检查这三个位置
Go 查找包的顺序很固定，出错时按这个顺序排查最省时间：
- 是否在项目根目录运行命令？
go run main.go必须在含go.mod的目录下执行，否则 Go 会退回到 GOPATH 模式（已过时且容易混乱） - 是否漏了
go mod tidy？它会自动补全go.mod中缺失的本地包路径（只要目录存在） - 是否有拼写不一致？比如
import "myapp/Utils"（大写 U）但目录是utils/（小写 u）——Linux/macOS 下路径区分大小写，Windows 虽不区分但 Go 工具链仍按规范校验
最常被忽略的是：开发者以为改了包名就能改变导入方式，其实真正起作用的只有目录结构和 go.mod 里的 module 声明。路径不对，再怎么调整 package 行也没用。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
