go 语言通过将结构体设为私有、方法设为公开，实现“仅可通过工厂函数获取实例+按接口使用”的封装模式，既保护内部实现，又提供灵活的扩展性和可测试性。
go 语言通过将结构体设为私有、方法设为公开，实现“仅可通过工厂函数获取实例+按接口使用”的封装模式，既保护内部实现，又提供灵活的扩展性和可测试性。
在 Go 中，type stack struct{}（小写首字母）是包内私有结构体，无法被外部包直接实例化；但其方法如 func (s *stack) Push(v interface{}) 若以大写字母开头（如 Push），则属于导出方法，对外可见。这种“私有类型 + 公开方法”的设计并非语法矛盾，而是 Go 封装哲学的核心实践之一——控制构造入口，开放行为契约。
✅ 核心用例一：受控实例化 + 方法调用
外部包无法 &stack{}，但可通过包提供的导出函数（如 NewStack()）获得该类型实例，并调用其导出方法：
// 示例：模拟 txscript/stack.go 的设计思想
package stackpkg
type stack struct {
data []interface{}
}
// 导出方法：外部可调用
func (s *stack) Push(v interface{}) {
s.data = append(s.data, v)
}
func (s *stack) Pop() (interface{}, bool) {
if len(s.data) == 0 {
return nil, false
}
v := s.data[len(s.data)-1]
s.data = s.data[:len(s.data)-1]
return v, true
}
// 导出工厂函数：唯一合法构造途径
func NewStack() *stack {
return &stack{data: make([]interface{}, 0)}
}
// 在 main.go 中使用
package main
import "your/module/stackpkg"
func main() {
s := stackpkg.NewStack() // ✅ 合法：通过工厂获取
s.Push("hello") // ✅ 合法：调用导出方法
val, ok := s.Pop() // ✅ 合法
_ = val; _ = ok
// var bad stackpkg.stack // ❌ 编译错误：cannot refer to unexported name stackpkg.stack
}
✅ 核心用例二：面向接口编程（Interface-based API）
更推荐的方式是定义导出接口，隐藏具体实现类型：
package stackpkg
type Stack interface {
Push(v interface{})
Pop() (interface{}, bool)
Len() int
}
type stack struct { /* ... */ }
func (s *stack) Push(v interface{}) { /* ... */ }
func (s *stack) Pop() (interface{}, bool) { /* ... */ }
func (s *stack) Len() int { return len(s.data) }
// 导出函数返回接口，而非具体类型
func NewStack() Stack {
return &stack{data: make([]interface{}, 0)}
}
优势显著：
- 解耦依赖：调用方只依赖 Stack 接口，不感知 stack 实现；
- 便于测试：可轻松注入 mock 实现（如 MockStack）；
- 支持多实现：未来可新增 ConcurrentStack 或 LimitedStack，无需修改调用方代码；
- 语义清晰：API 表达“能做什么”，而非“是什么”。
⚠️ 注意事项与最佳实践
- 私有结构体的导出方法必须满足接口契约，否则外部无法通过接口调用；
- 工厂函数（如 NewXXX()）应作为唯一构造入口，避免包内其他导出函数意外暴露构造逻辑；
- 若结构体需序列化（如 JSON），私有字段默认被忽略——此时应确保导出字段或实现 json.Marshaler；
- 不要试图绕过私有限制（如反射或 unsafe）：这破坏封装性、不可移植且违反 Go 设计原则。
总之，public method + private struct 不是语言缺陷，而是 Go 推崇的“显式构造 + 隐式实现”范式的体现——它让 API 更健壮、更易维护，也更符合大型工程对抽象与边界的严格要求。
