_tracemalloc 是 Python 内置内存追踪工具，可精准定位对象分配位置和内存热点；启用后通过快照对比，按文件行号统计内存分配量，并支持调用栈深度控制、路径过滤及增量分析。

_tracemalloc 是 Python 标准库中轻量、精准、开箱即用的内存分配追踪工具，专用于定位对象创建位置和识别内存热点。它不依赖外部包，无需修改代码逻辑，只需几行启用和快照对比，就能查出哪段代码、哪个文件、第几行分配了最多内存。

开启与基础快照操作

默认状态下 _tracemalloc 是关闭的，需手动启动并设置跟踪深度（即回溯调用栈层数）：

• 调用 tracemalloc.start(25) 启动，参数表示最多记录 25 层调用栈（常用 10–25，越大越精确但开销略增）
• 用 tracemalloc.take_snapshot() 拍摄当前内存分配快照，返回 Snapshot 对象
• 多次拍摄后可对比差异，例如分析某函数执行前后的内存增量

分析内存分配 Top N 位置

Snapshot 提供 statistics('lineno') 方法，按「文件名:行号」聚合统计，直接指出最耗内存的代码行：

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

• 结果包含 size（字节）、count（分配次数）、traceback（调用链），一目了然
• 加参数 'filename' 可按文件汇总；'traceback' 则返回完整调用栈对象，适合深入排查嵌套调用
• 示例：打印前 10 行内存大户：for stat in snapshot.statistics('lineno')[:10]: print(stat)

对比两次快照找内存增长点

用 snapshot1.compare_to(snapshot2, 'lineno') 计算差值，只显示新增或显著增长的分配项：

立即学习“Python免费学习笔记（深入）”；

• 适用于「执行某段逻辑前后」的内存变化分析，比如加载数据、渲染模板、处理一批请求
• 结果中 size_diff > 0 表示该位置多分配了内存；负值表示释放（较少见，因 tracemalloc 不追踪释放，仅反映净增长）
• 配合过滤（如 [s for s in diff if s.size_diff > 1024*1024]）可快速聚焦 MB 级增长点

实用技巧与注意事项

_tracemalloc 轻量但有边界，用对场景才能发挥价值：

• 它只跟踪 Python 堆上由 CPython 分配的内存（如 list、dict、str 实例），不包含 C 扩展直接 malloc 的内存（如 numpy 数组底层 buffer 需配合 memory_profiler）
• 启动越早越好——建议在脚本开头或应用初始化阶段就 start()，避免漏掉早期分配
• 注意 filter：可用 tracemalloc.Filter(inclusive=True, ...) 限定只跟踪指定路径，减少干扰（如排除 venv 或标准库）
• 生产环境慎用：开启后有约 5–10% 性能开销，且 snapshot 本身占内存，建议仅用于诊断期，勿长期运行