在 Go 中，通过将结构体设为不可导出（小写首字母）并仅提供导出的构造函数，可强制用户通过 New() 创建实例；但若需对外暴露行为接口而非具体类型，应定义导出接口并返回其实现，从而兼顾封装性、可用性与 golint 合规性。
在 go 中，通过将结构体设为不可导出（小写首字母）并仅提供导出的构造函数，可强制用户通过 `new()` 创建实例；但若需对外暴露行为接口而非具体类型，应定义导出接口并返回其实现，从而兼顾封装性、可用性与 golint 合规性。
Go 的导出规则（首字母大写才可被外部包访问）是实现 API 封装的核心机制。你当前的代码中，mystruct 是不可导出的，这确实阻止了外部直接字面量初始化（如 mypkg.mystruct{...}），但同时也导致 mypkg.New() 返回的 *mystruct 在调用方无法进行类型断言、方法调用或字段访问——因为该类型本身不可见。正如示例中所示，fmt.Println(x.S) 实际上无法编译通过（x 的类型在 main 包中不可识别），这违背了 API 的可用性原则。
✅ 正确做法是：导出接口，隐藏实现。
定义一个导出的接口（如 HaveS），声明所需行为（如 GetS() string），让不可导出的结构体实现该接口，再令 New() 返回接口类型。这样，调用方只依赖契约（接口），不感知具体实现，既满足封装要求，又保证代码可编译、可使用：
// mypkg/mypkg.go
package mypkg
type mystruct struct { // 不可导出：禁止外部直接构造
S string
}
// HaveS 是导出接口，定义可公开的行为
type HaveS interface {
GetS() string
}
func (m *mystruct) GetS() string { // 实现接口方法
return m.S
}
// New 返回接口类型，隐藏具体实现
func New() HaveS {
return &mystruct{S: "test"}
}
// main.go
package main
import (
"fmt"
"test/mypkg"
)
func main() {
x := mypkg.New() // ✅ 类型为 mypkg.HaveS，可正常使用
fmt.Println(x.GetS()) // ✅ 调用接口方法
// x.S // ❌ 编译错误：无法访问未导出字段
// _ = mypkg.mystruct{} // ❌ 编译错误：类型不可见
}
⚠️ 注意事项：
- 不要返回指针到不可导出类型（如 *mystruct）：外部无法声明该类型变量，导致返回值“存在但不可用”。
- 接口应聚焦契约：只包含调用方真正需要的方法，避免过度设计（如 Stringer 等通用接口需谨慎引入）。
- 构造函数可扩展：后续如需支持配置化创建，可在 New() 中添加参数，或提供 NewWithOption(...Option) 模式，而不影响已有接口契约。
- golint / staticcheck 提示本质是提醒：unexported struct 本身无错，但若其唯一出口（如 New()）返回不可用类型，则属于设计缺陷——工具在帮你发现 API 不一致问题。
总结：Go 的封装不靠“禁止访问”，而靠“只暴露必要契约”。用导出接口 + 不可导出实现 + 导出构造函数，三者协同，才能写出既安全、又易用、且符合 Go 惯例的包 API。
