编写公共类库的第一原则：管好你的 public
原文中文，约3800字，阅读约需9分钟。
📝
内容提要
在构建和维护 .NET 开源项目时，应遵循「管好你的 public」原则，避免在公共API中添加与核心目标无关的功能，以保持代码的可读性和稳定性。内部功能应设为 internal，以确保公共API的纯净和专注，避免复杂性和混淆。
🔎
延伸解读
公共API的设计原则
在设计公共API时，遵循「管好你的 public」原则至关重要。这不仅有助于保持代码的可读性和稳定性，还能增强用户对库的信任。开发者应时刻反思所暴露的功能是否与库的核心目标一致，避免引入不必要的复杂性。
避免私货的影响
在公共代码库中添加与核心目标无关的功能，即所谓的“私货”，会导致代码目的不明确，增加使用者的困惑。开发者应当谨慎评估每个public方法的必要性，确保其通用性和稳定性，以维护代码库的纯净性。
内部与公共的界限
将内部实现设为internal是保护公共API的重要策略。通过限制对具体实现的访问，开发者可以在不影响外部使用者的情况下自由修改和重构代码。这种做法有助于降低耦合度，提高代码的灵活性和可维护性。
❓
Q&A
什么是“管好你的 public”原则？
“管好你的 public”原则强调在公共API中避免添加与核心目标无关的功能，以保持代码的可读性和稳定性。
为什么要避免在公共API中添加‘私货’？
添加‘私货’会导致代码库目的不明确，引入不必要的复杂性，甚至给使用者带来困惑和麻烦。
如何处理内部功能与公共API的关系？
内部功能应设为internal，以确保公共API的纯净和专注，避免污染公共类型。
滥用object扩展方法会带来什么问题？
滥用object扩展方法会污染公共类型，缺乏可扩展性和控制力，并模糊类库的边界。
为什么不应该暴露宽泛的Util类？
暴露Util类会带来强烈主观偏好和命名冲突的问题，增加使用者的学习成本和依赖。
如何保持公共API的纯净和专注？
保持公共API的纯净和专注需要反问自己功能是否是核心职责，是否足够通用，并避免暴露实现细节。
🏷️
