函数传参规范：传递完整对象还是仅传所需属性？

这绝对是日常开发中经常纠结的问题，其实没有一刀切的标准答案，但有一些通用的指导原则可以帮你做判断：

1. 优先考虑可读性与维护性（绝大多数场景） #

在大多数业务开发场景里，传递完整对象的优势远大于所谓的“性能收益”：

• 语义更清晰：calculateSomething(car1, car2, aircraft)一眼就能看懂函数是在处理车辆和飞机实体，而calculateSomething(car1.speed, car1.length, car2.speed, aircraft.height)需要逐个对应参数含义，可读性差很多，尤其是参数多的时候。
• 扩展性更强：如果后续函数需要新增依赖的属性（比如突然要用到car1.weight），传递完整对象的话，只需要在函数内部直接调用，不用修改函数签名和所有调用处的代码，维护成本低很多。
• 减少参数冗余：避免出现一堆零散的参数，函数签名更简洁，也降低了传参顺序出错的概率。

2. 性能：别过早优化 #

你直觉里觉得“传递属性更高效”，其实在现代编程语言（不管是Java、Python、JavaScript这类）中，这种性能差异几乎可以忽略不计：

• 大多数语言里对象是引用传递，传递对象本质上只是传了个内存地址，开销极小，和传递几个基本类型的参数没什么区别。
• 只有在极端场景下（比如每秒调用数百万次的高频函数、处理超大规模数据集），才需要考虑这种微优化。而且优化前一定要先做性能测试，确认这真的是性能瓶颈——过早优化往往会牺牲可读性，反而给后续维护挖坑。

3. 特殊场景下的例外 #

当然也有适合传递单个属性的情况：

• 纯函数依赖独立值：如果函数是完全的纯函数，且依赖的是几个无关联的基本类型值，比如calculateArea(width, height)，传递单个参数比传递一个Rectangle对象更直接（不过如果后续需要扩展，比如加depth，还是对象更灵活）。
• 避免不必要的耦合：如果函数不需要了解整个对象的结构，只是需要某个特定值，传递属性可以减少函数和对象的耦合度——比如一个只需要速度值的函数，不用关心这个速度是来自汽车还是飞机，传speed参数更通用。
• 明确的性能瓶颈：已经通过测试确认，传递完整对象确实带来了可感知的性能损耗，这时候再针对性地传递所需属性，同时最好给函数加注释说明优化的原因。

4. 遵循团队规范 #

如果你的团队有统一的编码风格指南，优先遵循团队约定——代码的一致性比个人的偏好更重要，能减少团队成员之间的沟通成本。

总结 #

绝大多数情况下，优先选择传递完整对象，因为可读性和维护性带来的长期收益，远大于那点几乎可以忽略的性能差异。只有在经过严格的性能测试，确认传递对象是性能瓶颈时，再考虑传递仅需的属性，同时要做好代码注释，让后续维护的人明白为什么这么做。

内容的提问来源于stack exchange，提问作者wheeler