go跨包调用报错因小写函数未导出，编译期拒绝访问；import路径须严格匹配go.mod模块名；/internal/路径仅限同模块导入；json序列化等依赖字段首字母大写导出。
跨包调用函数时为什么报 cannot refer to unexported name
因为 Go 的可见性只看首字母大小写，不看文件位置或目录结构。小写字母开头的函数（如 helper()）在定义它的包内可用，但其他包 import 后也完全看不到它——编译器连签名都不暴露，不是运行时报错，是编译期直接拒绝。
常见错误场景：
- 你在
pkg/utils.go里写了func parseConfig() error，然后在cmd/main.go（属于main包）中 import "myapp/pkg" 后试图调用pkg.parseConfig()→ 报错 - 误以为 “同项目下就能用”，结果发现
go build失败，而 IDE 可能还显示“可跳转”（那是 IDE 缓存或路径解析偏差）
修复方式只有两个：要么把函数名改成 ParseConfig()，要么把调用代码挪到同一包下（比如写成 pkg/main_test.go，它和 pkg/utils.go 同属 pkg 包）。
import 路径必须严格匹配 go.mod 中的 module 声明
Go 不认本地文件路径，只认 import 字符串是否构成模块根路径的合法子路径。比如 go mod init github.com/you/project，那所有 import 都得从 github.com/you/project/... 开始。
典型错误：
-
import "./internal/db"→ 错，.和./在 import 中非法 -
import "project/internal/db"→ 错，缺了域名前缀，Go 不知道这是哪个模块 - CI 构建失败但本地 OK → 很可能 CI 工作目录是
/tmp/build/project，而go.mod里写的是module example.com/proj，导致导入路径无法对齐
验证方法：运行 go list -m 看当前模块名，再对照 import 语句是否以它为前缀。
internal 包被外部模块 import 时触发 use of internal package not allowed
这不是权限问题，也不是 Git 或网络限制，是 Go 编译器在 parse import 语句时硬编码的检查：只要路径含 /internal/，就只允许被同一模块根路径下的包导入。
也就是说，假设你的模块是 example.com/myapp，那么：
-
example.com/myapp/internal/log可被example.com/myapp/cmd或example.com/myapp/pkg导入 ✅ -
github.com/other/repo即使 fork 了你的代码、甚至改了go.mod，只要 import 语句里写了example.com/myapp/internal/log→ ❌ 立即报错 - 想让测试覆盖 internal 逻辑？别动路径，把
internal/db/db_test.go放进去，它天然属于internal/db包，能直接调用所有小写函数
JSON 序列化字段为空或接口实现失败，根源常是结构体字段未导出
encoding/json、database/sql、接口断言等机制全部依赖导出规则。字段名小写 → 包外不可见 → 这些库根本读不到值，不是 bug，是设计强制行为。
例如：
type User struct {
ID int
name string // 小写 → json.Marshal 输出 {"ID":1}，name 消失
}
注意：json:"name" tag 不起作用，tag 不绕过可见性检查。
正确做法只有：
- 字段名首字母大写：
Name string - 或者用嵌套导出类型 + 自定义 MarshalJSON 方法（复杂场景才需）
- 方法要被外部调用，接收者类型也必须导出：
func (u *User) GetName() string✅，func (u *user) GetName() string❌（user类型未导出，外部连构造*user实例都不行）
最易被忽略的一点：可见性检查发生在编译期，不是运行时。这意味着你没法靠反射、unsafe 或任何技巧绕过——它从语法树阶段就被砍掉了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
