首页 > 文章 > python教程

Python实现调用历史记录功能

时间：2026-01-23 22:48:47 200浏览收藏

一分耕耘，一分收获！既然打开了这篇文章《Python实现最近N次调用历史函数》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

使用装饰器+deque实现支持最近N次调用历史的函数，自动记录参数、返回值/异常、时间戳及耗时，并通过函数属性history暴露历史队列，支持清空、筛选和格式化输出。

Python 如何实现一个支持“最近 N 次调用历史”的函数

用 Python 实现一个支持“最近 N 次调用历史”的函数，核心是记录每次调用的参数、返回值（或异常）、时间戳，并自动维护固定长度的历史队列。推荐使用 collections.deque 实现 O(1) 的进出操作，再配合装饰器封装，简洁又实用。

用装饰器 + deque 自动记录调用历史

这是最常用、最灵活的方式：定义一个装饰器，在被装饰函数每次执行后，把关键信息存入双端队列，并限制最大长度。

使用 deque(maxlen=N) 天然支持“只保留最近 N 条”，超出时自动丢弃最老的一条
每条记录建议包含：args、kwargs、return_value 或 error、timestamp
通过函数属性（如 func.history）暴露历史列表，方便查询

示例代码：

from collections import deque
from datetime import datetime
from functools import wraps
<p>def track_history(max_calls=10):
def decorator(func):</p><h1>初始化带 maxlen 的 deque</h1><pre class="brush:php;toolbar:false"><code>    func.history = deque(maxlen=max_calls)

    @wraps(func)
    def wrapper(*args, **kwargs):
        start_time = datetime.now()
        try:
            result = func(*args, **kwargs)
            record = {
                'args': args,
                'kwargs': kwargs,
                'return_value': result,
                'error': None,
                'timestamp': start_time,
                'duration_ms': (datetime.now() - start_time).total_seconds() * 1000,
            }
            func.history.append(record)
            return result
        except Exception as e:
            record = {
                'args': args,
                'kwargs': kwargs,
                'return_value': None,
                'error': repr(e),
                'timestamp': start_time,
                'duration_ms': (datetime.now() - start_time).total_seconds() * 1000,
            }
            func.history.append(record)
            raise e

    return wrapper
return decorator</code>