如何在 Go 中正确使用私有函数（小写字母开头的函数）

go 语言通过首字母大小写严格控制标识符的可见性：小写字母开头的函数、变量或类型属于包私有，无法被外部包直接调用。试图跨包调用如 `blackfriday.doublespace` 会编译失败，唯一合规做法是自行实现等效逻辑。

在 Go 中，“私有性”并非运行时限制，而是由编译器强制执行的语言规范。根据 Go 语言规范，只有以大写字母开头的标识符才是导出的（exported），才能被其他包访问；而 doubleSpace 这样的小写函数，即使在同一模块中，只要不在 blackfriday 包内定义，就完全不可见——这与 Java 的 private 关键字语义类似，但机制更简洁、更彻底。

因此，以下写法均非法，会触发 undefined: blackfriday.doubleSpace 编译错误：

// ❌ 错误：非导出函数不可跨包访问
blackfriday.doubleSpace(out)
blackfriday.DoubleSpace(out) // ❌ 也不对：原函数名就是 doubleSpace，且未导出

✅ 正确做法是：在你的 main 包（或

自定义 renderer 所在包）中重新定义功能一致的函数。例如：

func doubleSpace(out *bytes.Buffer) {
    if out.Len() > 0 {
        out.WriteByte('\n')
    }
}

func (r *renderer) Paragraph(out *bytes.Buffer, text func() bool) {
    marker := out.Len()
    doubleSpace(out) // ✅ 调用本包内定义的同名函数

    out.WriteString("
")
    if !text() {
        out.Truncate(marker)
        return
    }
    out.WriteString("
\n")
}

⚠️ 注意事项：

• 不要尝试通过修改第三方包源码（如 fork 并导出 DoubleSpace）来绕过限制——这会增加维护成本、破坏依赖一致性，且违背语义化版本契约；
• 若该逻辑被多处复用，建议将其封装为独立的工具函数或小型 util 包，保持内聚与可测试性；
• Go 鼓励“组合优于继承”，也鼓励“复制清晰逻辑优于强行耦合私有实现”——这是社区推崇的务实设计哲学。

总结：Go 的包级封装是坚定而透明的。面对私有函数，无需寻找反射、unsafe 或构建 hack；只需理解其设计意图，用几行清晰代码重写即可——这既是约束，也是简化。