Go 无 package-private，仅通过首字母大小写控制可见性：大写导出，小写包内私有；同包文件天然共享小写符号；测试文件同包可直接访问；用 internal/ 目录实现跨包隔离。
Go 没有 package-private，只有首字母大小写控制的导出规则
Go 语言压根没有 Java 那种 package-private（默认访问级别）的概念。它只靠一个简单规则：标识符（函数、变量、类型等）是否以大写字母开头，决定它能否被其他包访问。小写开头的标识符只能在定义它的包内使用——这看起来像 package-private，但本质不同：它不是“默认限制 + 显式放宽”，而是“显式导出 + 其余全封闭”。
所以你不能“实现” Java 的 package-private，只能接受并适应 Go 的这套规则。关键在于：把所有不希望被外部调用的符号，一律用小写开头命名。
如何让同包内多个文件共享“内部”符号
Go 同一包下的所有 .go 文件天然共享作用域，只要符号是小写开头，它们就能互相访问，无需任何额外声明或 import。
常见错误现象：undefined: myHelper —— 实际是因为你在另一个文件里写了 MyHelper（大写），结果被当成导出符号，而调用处又没加包名前缀；或者相反，写成了 myHelper 却试图从外部包调用。
立即学习“Java免费学习笔记（深入）”；
- 确保 helper 函数、内部结构体字段、未导出方法都用小写开头，例如：
validateInput、userCache、id字段 - 不要在同包文件之间 import 自己的包名（Go 不允许）
- 如果拆分逻辑到多个文件，把共用的内部类型统一放在
internal.go或types.go中，保持命名一致
想阻止其他包访问，但又怕同包测试需要？
测试文件（_test.go）属于同一个包（除非用了 xxx_test 包名），因此能直接访问小写标识符。这是 Go 测试机制的设计前提，不用绕路。
容易踩的坑：go test 运行时，myapp_test.go 和 myapp.go 属于同一个 myapp 包，myHelper 可直接调用；但如果你新建了一个 myapp_test 包（比如为了黑盒测试），那就真访问不到了——这时就该反思：你是不是在测接口而非实现？
- 单元测试请保持和源码同包（即不写
package myapp_test） - 集成测试或端到端测试可另起包，但应通过导出的 API 调用，而不是强行“偷看”内部逻辑
- 不要为了测试而把本该小写的函数改成大写再加注释说 “仅供测试使用”——这等于开了后门
用 internal/ 目录做更严格的包级隔离
当项目变大，你需要比“同包可见”更强的约束：比如某个工具模块只供本项目几个特定包使用，不希望被其他无关包意外 import —— 这时用 internal/ 是标准解法。
Go 编译器会检查 import 路径：任何包含 /internal/ 的路径，只允许其父目录及父目录的子目录中的包 import 它。违反则报错：use of internal package not allowed。
- 把真正“内部专用”的代码放进
internal/utils/或internal/authz/ - 主业务包如
cmd/api和service/user可以 importmyproject/internal/authz，但第三方 fork 的包不行 -
internal/不是魔法，它只是编译期检查；运行时无特殊行为，也不影响性能或兼容性
真正容易被忽略的是：Go 的可见性模型是扁平且静态的，没有继承、没有友元、没有注解控制。一旦你接受了“小写 = 包内私有”，就别想着模拟 Java 那套语义——那只会让代码更难读、更易出错。
