functools是Python标准库中面向高阶函数操作的核心模块，提供了偏函数（partial）、缓存（lru_cache/cache）、装饰器辅助（wraps）和单分派（singledispatch）等工具，是Python开发者优化代码复用性和性能时不可或缺的依赖。
functools偏函数使用教程：从基础语法到实际应用
偏函数（partial）是functools模块中使用频率最高的工具之一，它的核心作用是将一个接受多个参数的函数“冻结”一部分参数，生成一个新函数，后续调用时只需传入剩余参数即可，Python官方文档中明确指出，partial适用于那些频繁重复传入相同参数的场景，例如在数据清洗流程中反复调用某个处理函数时固定分隔符或编码参数。
偏函数如何简化日常开发
假设你有一个日志记录函数log(level, message)，每次在模块内调用都需要传入level，通过partial(log, level='INFO')可以生成一个info_log函数，后续只需写info_log('用户登录成功')，这种用法在配置项固定的场景下能显著减少重复代码。
- 典型场景：数据库查询条件固定值、API请求的公共header、数学计算中的常量参数。
- 与lambda对比：partial不会产生新的命名空间，性能略优于lambda，且代码可读性更好。
- 实操注意：当原函数有默认参数时，partial只会覆盖你显式传入的参数，不影响其他默认值。
functools和装饰器区别：本质与用法对比
很多初学者容易混淆偏函数与装饰器,两者的核心区别在于“是否改变函数行为”，装饰器（如@property、@staticmethod）是在不修改函数主体的情况下增加额外功能，而偏函数只是预填参数，并不干预函数执行逻辑，用一个简单场景来区分：当你需要固定某些参数时用partial，当你需要在函数执行前后添加日志、权限检查或性能计时时用装饰器。
行业共识认为,在数据处理管线中，偏函数常用于构造特定的转换步骤，而装饰器更适合实现横切关注点（如事务、重试机制），具体到代码层级，偏函数返回一个可直接调用的函数对象，装饰器通常返回一个包装后的函数，两者在实际项目中还可以配合使用。
functools缓存与性能优化实例
functools的缓存组件一直是性能优化的重头戏,尤其在递归函数和重复计算场景下效果明显，lru_cache（Least Recently Used）和Python 3.9引入的cache（无大小限制的简单缓存）是其中的核心。
functools lru_cache性能优化实例：缓存机制与参数调优
lru_cache通过保存函数调用结果来避免重复计算,适用于输入域有限且计算开销大的函数，一个经典案例是斐波那契数列的计算，未优化时递归复杂度为O(2^n)，加上@lru_cache(maxsize=None)后复杂度降为O(n)，这里的maxsize是用来控制缓存条目数量的关键参数。
- maxsize的选择：若设置为None，缓存无限增长，适合小范围输入；若设置为正整数，则淘汰最久未使用的记录，适合内存敏感的环境。
- typed参数：设置为True时会区分整数1和浮点数1.0，默认False忽略类型差异。
- 实际效果：据统计，在大量重复参数调用的API网关中，合理使用lru_cache可以将平均响应时间压缩至原来的1/5左右（具体效果取决于请求分布）。
functools cache与lru_cache：版本选择建议
Python 3.9新增了functools.cache装饰器，它等价于lru_cache(maxsize=None)，但省去了参数配置，代码更简洁，如果你的函数输入空间不大且不需要限制缓存容量，优先用cache；如果输入可能爆炸或需要控制内存，则选择lru_cache并设置合理的maxsize，cache还支持与__wrapped__属性配合，便于测试时清空缓存。
- 版本兼容：cache在3.9+可用，lru_cache从3.2就开始支持。
- 性能差异：两者底层实现一致，cache不过是lru_cache的一个特例版本。
- 实践建议：在生产环境中，美团技术团队曾在技术分享中提到，对QPS较高的计算型模块使用cache时需监控内存占用，一旦发现增长过快应立即切换为显式maxsize的lru_cache。
functools高阶工具实践：wraps与singledispatch
除了偏函数和缓存,functools还有两个容易被忽视但极其实用的工具：wraps用于维持装饰器行为的一致性，singledispatch用于实现类型分派（类似函数重载）。
wraps保留装饰器元数据：避免name丢失
写装饰器时最常见的陷阱是原始函数的__name__、__doc__等属性被替换成包装函数的属性。@functools.wraps的使命就是解决这个问题，它通过拷贝原始函数的元数据到包装函数上，让被装饰的函数在外部看起来几乎和原来一样。
- 标准写法：在装饰器内部定义wrapper函数后，立即用
@wraps(func)装饰wrapper。 - 深层影响：使用wraps还能让被装饰函数正确支持签名检查和帮助文档生成，这在开发大型框架（如Flask扩展）时尤为重要。
- 常见错误：只在顶层装饰器使用wraps而忘了嵌套装饰器也需要，导致多层包装后的函数属性仍然丢失。
singledispatch实现函数重载：替代type判断
singledispatch允许你基于第一个参数的类型来选择不同的函数实现,而且无需编写冗长的if-elif链，该功能在Python 3.4中正式引入，特别适合那些需要针对不同类型数据做不同处理的场景，比如序列格式转换、数据校验等。
- 基础用法：用
@singledispatch装饰基函数，再用@base.register(type)注册特定类型的处理函数。 - 实际案例：一个
parse_data函数，对int类型做数字解析，对str类型做字符串分割，对list类型直接返回。 - 注意事项：singledispatch只分派第一个参数的类型，如果需要多参数分派，可以考虑
functools.singledispatchmethod（Python 3.8+）或第三方库。
functools常见问题解析
functools面试常见问题解析
在Python面试中,functools是高频考点，面试官通常围绕partial和lru_cache的底层原理、wraps的作用以及在实际编码中的应用展开。“如何手动实现一个简单的lru_cache功能？” 这需要理解双向链表和字典的组合，以及缓存淘汰策略，另一个常见问题是：“partial和默认参数有什么区别？” 区别在于默认参数在函数定义时固定，而partial可以在运行时动态创建新函数。
functools与itertools的区别
虽然两者都出现在标准库中,但分工完全不同，functools侧重函数组合与缓存，itertools侧重迭代器操作（如循环、分组、排列），实际项目里，它们经常协作：用itertools生成序列后，用functools中的偏函数传给处理逻辑。
缓存装饰器是否适用于异步函数
lru_cache和cache目前不原生支持协程（async def），对于异步函数，需要使用asyncio模块配合自定义缓存，或者等待标准库的直接支持，第三方库asyncache提供了对异步函数的缓存封装，参考了functools的设计思路。
结尾要记住，functools的核心价值在于提供标准化的工具来减少重复造轮子，无论你是编写框架还是业务代码，掌握这几种组件都能让你的代码更简洁、更专业。
关于functools模块的常见疑问解答
偏函数在数据处理中的性能开销大吗？
偏函数的本质是创建一个新的可调用对象,该对象会保存原函数和部分参数，每次调用它时，只是多了一层参数合并，性能损耗几乎可以忽略，业内专家指出，在单次调用中偏函数的耗时比直接调用原函数多不到0.1微秒，适合在循环内部使用。
何时应该使用functools.cache而不是手动字典缓存？
当你需要的缓存逻辑是简单的“一个输入对应一个输出”且不涉及TTL（过期时间）或持久化时，cache是最佳选择，它内置线程安全（CPython解释器下），而且代码量最少，但如果你需要清理特定缓存、记录命中率或控制缓存生命周期，手动字典缓存结合统计变量会更灵活。
为什么装饰器保留元数据要用functools.wraps而不是直接赋值？
直接赋值虽然也能复制__name__和__doc__，但wraps会利用functools.WRAPPER_ASSIGNMENTS和functools.WRAPPER_UPDATES这两个预定义集合，保证所有需要保留的属性（包括__module__、__annotations__等）被正确同步，并且会更新__dict__中的包装属性，这是官方推荐的唯一正确方式，手动赋值容易出现遗漏。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/functools/
