vscode无法一键生成python热力图，因其python插件仅支持cprofile文本报告，图形化需snakeviz/py-spy等外部工具配合终端命令或tasks.json任务封装。
VSCode 本身不内置 Python 性能热力图功能，但可通过 cProfile + snakeviz 或 py-spy 在 VSCode 终端中生成交互式热力图，无需离开编辑器。
为什么不能直接在 VSCode 编辑器里点一下就出热力图？
VSCode 的 Python 插件（Microsoft Python extension）提供调试、变量查看、断点等功能，但性能剖析属于运行时分析范畴，需外部工具链配合。插件默认只调用 python -m cProfile 输出文本报告，不渲染图形 —— 这是设计使然，不是配置错误。
-
cProfile是标准库，输出 .prof 文件，纯文本/统计结构，无可视化能力 -
snakeviz是独立 Web 可视化工具，依赖 Flask 启服务，必须手动启动 -
py-spy支持实时采样和火焰图，但需额外安装，且对多线程/异步代码更敏感
在 VSCode 终端里跑出热力图的三步实操
以当前脚本 main.py 为例，目标是生成可点击钻取的热力图（实际为火焰图，常被称作“热力图”）：
- 安装依赖：
pip install snakeviz（或pip install py-spy） - 生成 profile 文件：
python -m cProfile -o profile.prof main.py - 立即可视化：
snakeviz profile.prof→ 自动打开浏览器标签页，显示交互式火焰图
注意：snakeviz 启动的是本地 http://127.0.0.1:8080，VSCode 内置终端不拦截该行为；若浏览器未自动弹出，复制地址手动访问即可。
vscode 调试配置 launch.json 中加性能参数？不行
launch.json 的 python type 配置项不支持传入 -m cProfile 类参数。试图这样写会失败：
{
"name": "Profile with cProfile",
"type": "python",
"request": "launch",
"module": "cProfile", // ❌ 错误：launch 模式不接受 module 字段
"args": ["-o", "profile.prof", "main.py"]
}
正确做法是绕过调试器，改用终端命令，或写个简单任务（.vscode/tasks.json）封装：
{
"version": "2.0.0",
"tasks": [{
"label": "profile-main",
"type": "shell",
"command": "python -m cProfile -o profile.prof ${file} && snakeviz profile.prof",
"group": "build",
"presentation": { "echo": true, "reveal": "always", "focus": false }
}]
}
之后按 Ctrl+Shift+P → “Tasks: Run Task” → 选 profile-main，一键完成。
容易被忽略的细节：异步/多进程代码 profiling 失效
如果你的 main.py 含 asyncio.run()、multiprocessing.Process 或 concurrent.futures，cProfile 默认只 profile 主进程主线程：
- 子进程代码不会被记录 → 看起来“耗时全在 main()”，实际热点在 worker 里
- async 函数调用栈扁平 →
await后的函数可能被归到事件循环层，热力图失真 - 解决方案：用
py-spy record -o profile.svg --pid $(pgrep -f 'main.py')（Linux/macOS），或加--duration 10采样 10 秒
这类情况无法靠 VSCode 插件自动识别，必须人工判断执行模型再选工具 —— 这是进阶用户最容易卡住的地方。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
