参数数量说明什么
参数数量反映一个函数或模块对外的依赖面：参数越多，调用方需要准备的信息越多，改动时受影响的调用点也越多。参数超过四个通常值得审视，往往意味着几个总是同时出现的数据缺少一个载体。与之配套的两个结构指标是扇入与扇出：扇入是被多少模块引用，扇出是引用了多少模块，二者共同刻画一个模块在依赖图中的位置。
指标口径
| 参数数量 | 超过四个触发审视，常见成因是数据泥团 |
|---|---|
| 扇入 | 被多少模块引用，数值高说明是稳定核心 |
| 扇出 | 引用多少模块，数值高说明自身脆弱、易受影响 |
| 组合读法 | 高扇入低扇出是稳定基础模块，低扇入高扇出是边缘集成点 |
典型使用场景
- 评审发现参数列表过长：先看是否有一组字段总是一起出现，聚成对象再传
- 评审改动影响面：查目标模块的扇入，决定是否需要扩大回归范围
- 定位脆弱模块：扇出偏高说明一处外部变更就可能影响它
- 接口设计取舍：基础库应追求稳定的窄接口，集成层可以承载更多依赖
- 重构前的风险判断：扇入高的模块改动需要更严格的评审与验证
观察示例
观察示例
# 依赖位置决定改动策略
模块 A fan-in=42 fan-out=3 → 稳定核心，任何改动都要重评审、跑全量回归
模块 B fan-in=1 fan-out=18 → 边缘集成点，适合用适配层隔离外部变化
# 参数审视
createOrder(id, name, phone, addr, city, zip, note) → 地址字段聚成一个对象
createOrder(id, customer, note) → 依赖面明显收窄参数形态与处理
| 形态 | 问题 | 处理方向 |
|---|---|---|
| 五个以上散装参数 | 调用点需要对照参数表才能读懂 | 把总是一起出现的字段聚成对象 |
| 布尔标志参数 | 调用点看不出行为差异 | 拆成命名明确的两个方法 |
| 同一对象被拆成多个字段传入 | 调用方承担取值与拼接成本 | 直接传递对象本身 |
| 输出参数与返回值混用 | 调用顺序影响结果，易误用 | 改为返回组合结果对象 |
| 参数仅用于内部计算 | 调用方暴露了不该知道的细节 | 把参数来源移到函数内部 |
参数数量不是越低越好：把不相关的数据强行聚成一个对象，会让依赖范围从字段级扩大到对象级，调用方看不出真正需要什么。聚合的前提是这些字段确实总是一起出现。
扇入统计最好按模块或包聚合后再看，单看函数级数值容易被工具的口径差异影响。趋势比绝对值更有用：扇入在上升说明模块正在成为核心，需要同步补充文档与测试。
落地检查清单
- 超过四个参数的函数有明确处理结论
- 高扇入模块有稳定的接口与充分测试
- 高扇出模块的外部依赖通过适配层隔离
- 依赖图中的环与跨层依赖已列入整改清单