Go包导入失败或标识符不可见，90%源于路径、包名、首字母大小写未对齐：import路径须严格匹配go.mod的module声明与目录结构；包声明名需与目录名一致；首字母小写标识符仅包内可见；internal包仅限同模块内导入。
Go 包导入失败或标识符不可见，90% 是路径、包名、首字母大小写三者之一没对齐，不是环境或工具问题。
import 路径必须匹配模块根 + 目录结构
Go 不查 GOPATH 或配置文件，import 字符串就是从模块根开始的**字面路径**。比如 go mod init example.com/myapp，那 myapp/internal/utils 就得写成 import "example.com/myapp/internal/utils"，不能省略 example.com/，也不能写成 import "./internal/utils"。
- 目录名是
utils，但包声明是package helper？能编译，但其他地方import "example.com/myapp/utils"后只能用helper.Xxx，不是utils.Xxx - 项目在
/home/user/myproject，但go.mod里写的是module github.com/you/myproject，那所有import都得用github.com/you/myproject/xxx，哪怕你本地路径完全不同 - IDE 显示“找不到包”但
go build成功？大概率是 IDE 缓存了旧的go.mod路径，删掉go.work或重启 Go plugin
首字母小写 = 包内私有，JSON 和接口实现也绕不过
可见性检查发生在编译期，encoding/json、database/sql、接口断言全受约束。字段或方法名小写，外部包连签名都看不到，更别说序列化或调用了。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
type User struct { ID int; name string }→json.Marshal只输出{"ID":1}，name消失，加`json:"name"`tag 无效 -
func (u user) GetID() int无法被外部实现接口，因为接收者类型user未导出；必须写成func (u User) GetID() int - 测试时想调用私有函数？别 export，直接写同包的
xxx_test.go文件，它和源码在同一个包里，可直接调
internal 包报错不是权限问题，是编译器硬拦截
use of internal package not allowed 这个错误不是警告，是 go build 在解析 import 语句时立即终止。它不看 git 远程地址，只比对 import 路径字面量是否属于当前模块根路径的子树。
-
example.com/myapp/internal/db只能被example.com/myapp/cmd、example.com/myapp/pkg导入，github.com/other/repo即使 fork 了你的代码也不行 - CI 构建失败但本地 OK？检查 CI 的工作目录是否把项目放到了
/tmp/build/myapp这类路径下，而go.mod里模块名却是example.com/myapp—— 路径不匹配就触发拦截 - 想让测试代码访问 internal 逻辑？不要改路径，把测试文件放在同一包下（如
internal/db/db_test.go），它天然有权访问所有标识符
最容易被忽略的是：这些规则全部在 go build 第一阶段执行，还没到类型检查或链接。所以报错信息里不会出现行号，只告诉你 “import path mismatch” 或 “unexported name”。盯住 go.mod 的 module 行、import 字符串、以及每个 .go 文件顶部的 package 声明，三者对齐了，80% 的导入和可见性问题就消失了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
