本文提出了一条API设计准则：当两个公共函数共享实现逻辑时，应提取为私有辅助函数，而非让一个公共函数调用另一个。这能避免公共API为内部复用而累积冗余的可选参数，保持对外接口简洁。 shortcut API（刻意串联多个公共函数的快捷方式）是此规则的例外情况。
背景
作者Aleksandr Gurevich（matklad）是知名Rust贡献者及rust-analyzer创建者。本文针对具有显式公有/私有可见性修饰符的语言，提出了一条关于API表面设计的实用经验法则。
- 来源
- Lobsters
- 发布时间
- 2026年11月1日 02:05
- 评分
- 5.0 / 10