编写公共类库的第一原则：管好你的 public
💡
原文中文，约3800字，阅读约需9分钟。
📝
内容提要
在构建和维护 .NET 开源项目时，应遵循「管好你的 public」原则，避免在公共API中添加与核心目标无关的功能，以保持代码的可读性和稳定性。内部功能应设为 internal，以确保公共API的纯净和专注，避免复杂性和混淆。
🎯
关键要点
- 在构建和维护 .NET 开源项目时，应遵循「管好你的 public」原则。
- 避免在公共API中添加与核心目标无关的功能，以保持代码的可读性和稳定性。
- 内部功能应设为 internal，以确保公共API的纯净和专注。
- ‘私货’指的是在公共代码库中添加与核心目标无关的功能。
- 滥用 object 扩展方法会污染公共类型，缺乏可扩展性和控制力。
- 暴露宽泛的 Util 类会带来强烈主观偏好和命名冲突的问题。
- 泄露具体的实现类会导致强耦合和破坏性变更。
- 保持公共API的纯净和专注是优秀开发者的必备素养。
- 每一行 public 代码都是对使用者的承诺，应该是稳定、清晰、且专注的。
- 在封装公共库时，要反问自己功能是否是核心职责，是否足够通用。
➡️
