go跨包调用函数报undefined的根本原因是函数未导出：首字母小写导致编译器直接过滤，即使import路径正确、包存在且已定义，也因不满足导出规则（首字母大写、包级顶层定义、无receiver）而不可见。
Go 里跨包调用函数不是“能不能”的问题，而是“导出不导出”的编译期硬规则——func 名首字母小写，其他包连名字都看不到，更别说调用了。
为什么 import 了还是报 undefined 或 cannot refer to unexported name
这不是 import 路径写错、go mod 没初始化，也不是 IDE 显示有误。根本原因是：Go 编译器在解析阶段就直接过滤掉了所有首字母小写的标识符。
- 看到
cannot refer to unexported name pkg.getData→ 立刻打开pkg包里getData的定义，看它是不是小写开头 - 看到
undefined: pkg.ParseConfig→ 先确认ParseConfig真在该包文件里定义了；再检查拼写（Parseconfig不行）；最后核对首字母是否大写 - 结构体能 new 出来但字段全是零值，或
invalid field报错 → 问题不在结构体名，而在字段名，比如type User struct { name string }中的name小写，外部无法访问
跨包调用必须满足的三个硬性条件
缺一不可，少一个都会编译失败：
-
func必须是包级函数（不能带 receiver，即不能是func (s *Svc) Do()这种方法） - 必须在包文件顶层定义（不能嵌套在
if、for或另一个func内部） - 函数名首字母必须大写（如
GetData✅，getData❌）
结构体、字段、常量、变量……所有包级标识符，都遵循同一套大小写导出规则。没有例外，也不认注释或配置。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
import 路径和包名不是一回事，搞错就调不到
你在 import "github.com/you/myapp/utils" 后，调用的是 utils.SomeFunc()，这里的 utils 是 import 路径最后一段，跟 utils.go 文件里写的 package helpers 毫无关系。
- 如果
utils.go里写的是package helpers，那导入路径也得是"github.com/you/myapp/helpers"，否则 Go 找不到符号 -
import "./utils"或import "project/utils"在 Go Modules 下必然失败——Go 只认以go.mod中module声明为前缀的完整路径 -
import _ "pkg"不会让任何函数可用，它只触发init()，不暴露任何标识符
internal 包被外部模块 import 会直接编译失败
只要 import 路径里含 /internal/，Go 编译器会在 parse 阶段硬拦截：只有同一模块根路径下的包才能导入它。这不是权限或网络问题，是语言层面的强制约束。
- 错误信息是：
use of internal package not allowed - CI 构建失败但本地 OK？大概率是 CI 工作目录和
go.mod声明的模块路径没对齐，运行go list -m对照 import 路径就能定位 - 想让别人复用你的内部逻辑？别放
/internal/，改用公开子包，比如/pkg/xxx
最容易被忽略的一点：导出规则对 JSON 序列化、反射、数据库 ORM 字段映射全生效。哪怕你加了 json:"name" tag，字段名小写照样不会被 json.Unmarshal 赋值——因为反射也拿不到非导出字段。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
