函数扇入数（Fan-in）
在软件工程中，函数扇入数（Fan-in） 是一个衡量代码结构和模块化质量的指标。以下是详细解析：
定义
函数扇入数 指 调用某个函数的上级调用者数量（直接调用该函数的模块/函数总数）。
简言之：有多少个不同的函数调用了当前函数。
| 示例 | 扇入数 | 说明 |
|---|---|---|
函数 A() 被 Func1()、Func2() 调用 | 2 | 两个调用者 |
工具函数 Utils.log() 被整个系统调用 | 高扇入 | 表明该函数被广泛复用 |
为什么函数扇入重要？
-
模块化与复用性
高扇入 通常表示该函数被多处复用（如工具函数、公共库），是良好设计的标志：
✅ 减少代码重复
✅ 逻辑集中，易于维护 -
稳定性影响
修改一个高扇入函数可能影响大量调用者，需谨慎测试：
⚠️ 修复其 Bug 会修复多处问题
⚠️ 错误修改会导致大规模故障 -
与扇出（Fan-out）的对比
- 扇入：被多少人调用（受欢迎程度）
- 扇出：调用多少人（依赖他人程度）
扇入 vs. 函数参数个数
⚠️ 常见误区：扇入 ≠ 函数参数数量！
- 参数数量：函数输入端的参数个数（如
func(a,b,c)参数为3） - 扇入：调用该函数的上级函数数量
实际应用场景
-
识别核心工具函数
高扇入函数通常是系统的核心工具（如日志记录、加密模块），需重点保障其健壮性。 -
重构指导
- 若一个函数扇入为0：可能未被使用，可考虑删除。
- 若函数扇入突然增加：检查是否过度耦合，考虑拆分逻辑。
-
架构设计
分层架构中，底层服务通常具有高扇入（被上层多个模块调用）。
代码示例
# 高扇入函数：被多个调用者使用
def format_date(date): # 扇入数 = 调用它的函数数量return date.strftime("%Y-%m-%d")# 调用者1
def generate_report_A():format_date(today) # ✅ 调用# 调用者2
def generate_report_B():format_date(yesterday) # ✅ 调用# 调用者3
def save_log():format_date(now) # ✅ 调用
此处 format_date() 的扇入数 = 3（被3个函数调用）。
理想设计原则
- 追求高扇入
鼓励复用，减少冗余代码（符合DRY原则）。 - 控制扇出
单个函数避免调用过多其他函数（通常保持 < 7，降低复杂度）。 - 平衡抽象层级
高扇入函数应处于较低抽象层（如工具类），避免包含业务逻辑。
🔍 关键总结：函数扇入衡量的是被复用程度，而非内部复杂度。高扇入是优秀设计的体现，但也需警惕其变更带来的高风险。