go通过首字母大小写控制标识符导出性:大写对外可导出,小写仅包内可见;结构体字段、类型、方法的可见性均独立取决于其自身名称首字母,而非接收者或结构体类型名。

Go 里没有“私有成员”和“公有成员”的概念
Go 不像 Java 或 C++ 那样靠 private、public 关键字控制访问权限。它只有一套极简规则:**首字母大写的标识符(函数、变量、结构体字段、方法等)对外可导出(exported),小写的不可导出(unexported)**。这个“对外”,指的是包外——同一包内无论大小写都能访问。
结构体字段大小写决定能否被其他包读写
这是最常踩坑的地方。结构体字段是否可被外部包访问,只看字段名首字母,跟结构体本身是否大写无关。
-
type User struct { Name string; age int }:外部包能读写Name,但无法访问age字段(编译报错cannot refer to unexported field 'age' in struct literal) -
type user struct { Name string }:整个结构体类型user本身就不能被其他包引用(连声明变量都不行),哪怕字段全大写也没用 - 想让字段“只读”?Go 没有只读修饰符,只能靠约定:提供
GetAge()方法,不暴露age字段本身
方法名大小写影响能否被外部调用
方法的可见性取决于方法名,而不是接收者类型名。即使接收者是小写类型,只要方法名大写,且该类型能在包外被使用(即类型名也大写),方法就能被调用。
type user struct{ name string }
func (u user) Name() string { return u.name } // ✅ 外部可调用:方法名大写,且接收者类型虽小写,但此方法只能在本包用(因为 user 类型不可导出)
func (u *user) SetName(n string) { u.name = n } // ❌ 外部根本拿不到 *user,所以这方法实际对外不可见
type User struct{ name string }
func (u User) Name() string { return u.name } // ✅ 可导出类型 + 可导出方法 → 外部可用
func (u *User) SetName(n string) { u.name = n } // ✅ 同上
跨包使用时常见错误现象
典型报错不是语法错误,而是编译器直接拒绝你“看见”某些东西:
立即学习“go语言免费学习笔记(深入)”;
-
undefined: xxx:想用一个首字母小写的函数/变量/类型,但它没导出 -
cannot refer to unexported field 'xxx' in struct literal:试图在其他包中用字面量初始化含小写字段的结构体 -
cannot call unexported method:方法名小写,或接收者类型不可导出导致方法实质不可见 - 别指望 IDE 自动补全小写标识符——它们根本不在导出符号表里
真正麻烦的不是规则本身,而是习惯思维带来的误判:比如以为给结构体加个 public 标签就能导出字段,或者把方法名改成大写却发现接收者类型还是小写,结果方法依然不可用。










