Go中无私有包概念,但可通过小写标识符控制导出、internal目录限制导入、接口抽象隐藏实现、避免internal单独发布四种方式实现封装。

在 Go 中,私有包本身并不存在——Go 没有像 Java 或 C# 那样的访问修饰符(如 private、protected)。但你可以通过包级作用域可见性规则和目录结构设计来有效封装内部实现,阻止外部直接访问非公开逻辑。
使用小写字母开头的标识符控制导出范围
Go 的可见性由标识符首字母决定:大写(如 MyFunc)表示导出(public),小写(如 myFunc)表示未导出(private to the package)。这是最基础也是最关键的封装机制。
- 所有函数、类型、变量、常量若以小写字母开头,仅在定义它的包内可访问
- 即使其他包导入了该包,也无法调用
myHelper()或访问defaultConfig - 注意:嵌套结构体字段也遵循此规则 —— 小写字段无法被外部包读写
将内部实现拆分为独立的 internal 包
Go 官方推荐使用 internal/ 目录来存放仅限特定父级路径使用的代码。构建工具(如 go build)会强制检查:只有 internal 的直接父目录及其子目录下的包才能导入它。
- 目录结构示例:
myproject/internal/dbutil/和myproject/internal/authz/ -
myproject/cmd/api/可以导入myproject/internal/dbutil -
github.com/others/project尝试导入会报错:use of internal package not allowed - 注意:
internal是约定而非语法,依赖 Go 工具链的路径检查
通过接口暴露抽象能力,隐藏具体实现
对外只导出接口类型,把具体结构体和构造函数设为小写,迫使调用方只能通过工厂函数或配置函数获取实例,且无法直接修改内部状态。
立即学习“go语言免费学习笔记(深入)”;
- 定义导出接口:
type Cache interface { Get(key string) (any, bool) } - 实现结构体不导出:
type redisCache struct { client *redis.Client } - 提供导出的构造函数:
func NewCache(opts ...Option) Cache - 调用方只能用接口方法,不能访问
redisCache.client等细节
避免将内部包发布到公共模块路径
如果你用 go mod 管理依赖,确保 internal 子目录不被单独发布为可 go-get 的模块。模块路径应指向顶层(如 example.com/myapp),而不是 example.com/myapp/internal。
- 在
go.mod中声明主模块路径为根目录,不要为internal/下的子目录创建额外module声明 - CI/CD 或文档中避免给出
go get example.com/myapp/internal/xxx这类错误示例 - 必要时可在
internal包的doc.go中加注释说明:“仅供本项目内部使用,禁止外部导入”










