memory_profiler需用python -m memory_profiler启动或配合@profile装饰器使用,不能直接运行脚本;安装须匹配环境(pip/conda),输出关注mem usage与increment列,配合tracemalloc定位对象类型。

直接装 memory_profiler 就能用,但得配好 Python 环境和启动方式
memory_profiler 不是开箱即用的“图形界面工具”,它依赖 Python 的 line profiler 机制,必须用 python -m memory_profiler 启动,或者在函数上加 @profile 装饰器后用该命令运行脚本——直接 python script.py 不会触发内存行级采样。
常见错误现象:ImportError: No module named memory_profiler 或运行无任何内存输出。原因多是:没激活对应虚拟环境、pip 安装到了系统 Python、或用了 conda 但未 conda install memory_profiler(conda-forge 渠道更稳)。
- 推荐安装命令:
pip install memory_profiler(Python 3.7+),若用 conda:conda install -c conda-forge memory_profiler - 验证是否生效:
python -m memory_profiler --help应输出帮助信息 - 不建议全局 pip install;多项目时优先在 venv 或 conda env 中安装,避免版本冲突
@profile 装饰器必须配合 python -m memory_profiler 运行才有效
很多人写了 @profile 却发现没输出,是因为误以为加了装饰器就能自动记录——它只是打了个标记,真正触发分析的是运行时的解释器钩子。
正确做法是把目标函数写进一个独立脚本(比如 main.py),然后终端执行:python -m memory_profiler main.py。如果脚本里有多个 @profile 函数,只有被调用到的才会被分析。
- 装饰器本身不带参数,写法固定:
@profile单独一行,下一行才是def - 不能用于交互式环境(如 IPython/Jupyter)的普通单元格;需用
%memit魔法命令替代 - 若函数嵌套调用,只分析被装饰的那层;深层调用需逐层加装饰器或改用
tracemalloc全局跟踪
输出结果里重点关注 “Mem usage” 差值和 “Increment” 列
memory_profiler 默认按行输出两列关键数据:Mem usage(当前行执行完后的内存占用 MB)和 Increment(该行相比上一行新增的内存 MB)。泄漏往往藏在 Increment 持续为正、且数值随循环次数线性增长的行上。
例如以下代码片段:
from memory_profiler import profile <p>@profile def load_data(): data = [] for i in range(10000): data.append([i] * 100) # ← 这行 Increment 会稳定在 ~80KB/次 return data</p>
运行后你会看到该行的 Increment 反复出现相近正值,说明每次 append 都在堆上分配新对象且未释放。
- 注意单位:默认是 MB,小对象增量可能显示为 0.0;可加参数
-M改用 KB 级别精度:python -m memory_profiler -M main.py - 避免干扰:分析前关闭无关进程,尤其浏览器、IDE 插件,否则 RSS 波动会掩盖真实增量
- 增量为负不等于释放成功——可能是 GC 回收了旧对象,也可能是 profiling 自身开销抖动;要观察趋势,不是单点值
与 tracemalloc 搭配使用才能定位到具体对象类型
memory_profiler 告诉你“哪行代码吃内存”,但不告诉你“吃的是什么对象”。一旦发现某行 Increment 异常高,下一步必须切到 tracemalloc 查分配源头。
典型协作流程:先用 memory_profiler 锁定可疑函数 → 在该函数开头加 tracemalloc.start(25) → 执行后取 snapshot → 用 snapshot.statistics('lineno') 查出该函数内哪些代码行创建了最多 list、dict 或自定义类实例。
-
tracemalloc是标准库,无需安装,但只支持 Python 3.4+ - 务必限制栈深度(如
start(25)),否则 snapshot 体积爆炸、解析极慢 - 不要在
@profile函数里同时 start/tracemalloc 并 take_snapshot —— profiling 本身会干扰 trace,应分两次运行
实际排查中,最易被忽略的是:把 memory_profiler 当成“内存泄漏检测器”来用。它本质是“内存用量监测器”,只能反映增长,不能判断是否泄漏。真要确认泄漏,还得结合 gc.collect() 后对象数量是否回落、objgraph.show_growth() 是否持续增加某类实例——否则你优化了半天,可能只是把缓存从内存移到了磁盘。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











