当前位置：首页 > news >正文

Python学习笔记26：进阶篇(十五)常见标准库使用之性能测试cProfile模块学习使用

news 2025/6/27 13:58:33

前言

本文是根据python官方教程中标准库模块的介绍，自己查询资料并整理，编写代码示例做出的学习笔记。

根据模块知识，一次讲解单个或者多个模块的内容。

教程链接：https://docs.python.org/zh-cn/3/tutorial/index.html

本文主要记录性能测试cProfile模块的知识。

cProfile

cProfile是Python标准库中的一个性能分析模块，用于程序代码的性能剖析，帮助开发者找出程序中的瓶颈，以便进行优化。它提供了对程序运行时的函数调用次数、总时间、自耗时间等统计信息。

主要特点：
非侵入性：cProfile可以在不修改代码的情况下对程序进行性能分析。
精度高：相比于Python自带的timeit模块，cProfile能提供更详细的函数级性能数据。
输出格式灵活：结果可以输出到命令行、文件或进一步处理。

常用函数

cProfile.run

cProfile.run(statement, filename=None, sort=-1)

statement: 要分析的代码字符串，可以是函数名、表达式等。
filename: 可选参数，如果提供，则将分析结果保存到该文件中，而不是打印到控制台。
sort: 排序方式，决定输出结果的顺序。默认为-1，表示按累计时间降序排列。其他选项有’cumulative’、‘time’、'calls’等。

import cProfiledef test_func():# 示例函数，进行一些操作for i in range(10000):if i % 2 == 0:print("偶数")else:print("奇数")# 上述代码将分析test_func的执行情况，按照累计时间降序排列输出结果。
cProfile.run('test_func()', sort='cumulative')

在这里插入图片描述

这里介绍一下函数输出结构：

ncalls: 表示函数被调用的次数。如果是递归函数，这个数字会包括所有层级的调用。
tottime: 函数执行所消耗的总时间，不包含其调用的子函数所消耗的时间。单位通常是秒。
percall: 平均每次调用该函数所花费的时间（tottime除以ncalls）。
cumtime: 函数及其内部调用的所有子函数所消耗的总时间。这是一个“累计”时间，反映了调用该函数对整体运行时间的贡献。
percall (cumulative): 累计时间的平均值，即每次调用该函数及其子函数的平均总耗时。
filename:lineno(function): 这部分显示了函数所在的文件名、行号以及函数名称，便于定位代码位置。

结合上面内容，解释一下输出的信息：

总共进行了10004次输出，共执行了0.041秒
按照累计时间排序
{built-in method builtins.exec}
ncalls: 1次调用
tottime: 0.000秒，直接执行时间几乎为零
percall: 0.000秒，平均每次调用的直接时间
cumtime: 0.041秒，包括子函数在内的总执行时间
percall (cumulative): 0.041秒，累计时间的平均值
location: {built-in method builtins.exec}，表示这是一个内置的exec方法调用，通常用于执行字符串形式的代码块。
< string >:1(< module >)
同样被调用1次，直接时间和累计时间均为0.041秒，表明这是顶级代码块的执行，可能是脚本的入口点。
part_two.py:4(test_func)
ncalls: 1次调用
tottime: 0.002秒，函数test_func直接执行耗时
percall: 0.002秒，test_func每次调用的直接时间
cumtime: 0.041秒，包括内部调用的总时间，与上一行相同，意味着这个函数或是其内部调用占了大部分时间
percall (cumulative): 0.041秒，累计时间的平均值
location: part_two.py:4(test_func)，表明这是来自part_two.py文件第4行的test_func函数。
{built-in method builtins.print}
ncalls: 10000次调用
tottime: 0.039秒，直接执行时间总和
percall: 0.000秒，平均每次调用的直接时间非常短，表明单次打印操作非常快
cumtime: 0.039秒，累计时间也是0.039秒，因为这里是直接调用，没有子函数影响
percall (cumulative): 同样是0.000秒
location: {built-in method builtins.print}，表示这是内置的print函数调用。
{method ‘disable’ of ‘_lsprof.Profiler’ objects}
ncalls, tottime, percall, cumtime, percall (cumulative) 全部为0，表示这是关闭Profiler的调用，几乎不占用时间
location: {method ‘disable’ of ‘_lsprof.Profiler’ objects}，指的是关闭cProfile Profiler的方法调用。

从这份报告中可以看出，test_func函数及其内部操作（可能包括调用print）是导致程序执行时间较长的主要原因，而直接执行print函数虽然被调用了大量次数，但由于单次执行效率高，对总执行时间的贡献相对较小。

非常枯燥的报告，但是要习惯并且耐心看。

cProfile.runctx

与cProfile.run函数类似，但允许更精细地控制执行环境。

cProfile.runctx(statement, globals, locals, filename=None, sort=-1)

statement: 要分析的代码字符串，可以是函数名、表达式等。
filename: 可选参数，如果提供，则将分析结果保存到该文件中，而不是打印到控制台。
sort: 排序方式，决定输出结果的顺序。默认为-1，表示按累计时间降序排列。其他选项有’cumulative’、‘time’、'calls’等。
globals: 传递给代码执行的全局变量字典。
locals: 传递给代码执行的局部变量字典。

def profiled_func(x):return x * xglobals_dict = {'profiled_func': profiled_func}
locals_dict = {'x': 10}cProfile.runctx('profiled_func(x)', globals_dict, locals_dict)