VSCode本身不内置性能剖析能力，真正干活的是底层调试器或语言运行时的profiler；需正确配置扩展和后端工具（如py-spy、--inspect）才能生成并查看火焰图。
VSCode 里直接看火焰图？别折腾，先确认你有正确的调试器
VSCode 本身不内置性能剖析能力，它只是个前端界面，真正干活的是底层调试器（如 lldb、gdb、py-spy、node --inspect）或语言运行时的 profiler。如果你点开“运行和调试”面板却找不到“开始性能分析”按钮，不是 VSCode 坏了，是你没装对扩展或没配对后端工具。
常见误区：装了 Python 扩展就以为能 profile；其实默认只支持断点调试，cProfile 或 py-spy 需手动触发或靠额外扩展（如 Python Profiler）集成。
- Python：优先用
py-spy（无需修改代码，支持生产进程），配合vscode-py-spy扩展可直接在 VSCode 里生成火焰图 - Node.js：必须启用
--inspect启动，并在 VSCode 的launch.json中设置"trace": true或用 Chrome DevTools 连接，VSCode 自带的 Node 调试器不输出 CPU profile 文件 - C/C++：依赖
lldb+perf（Linux）或Intel VTune（Windows/macOS），VSCode 仅作日志查看器，不能直接采样
launch.json 怎么写才能让 profile 数据进 VSCode
很多用户改了 launch.json 却看不到 profile 面板，问题出在“VSCode 不解析 profiler 输出，只认特定格式的 trace 文件”。它原生只理解 Chrome DevTools Protocol（CDP）格式的 .cpuprofile，其他格式（如 cProfile 的 .prof、perf 的 perf.data）得转成 JSON 再拖进去。
以 Node.js 为例，正确配置的关键是两步：启动时暴露调试端口，再用外部工具采集并导出 CDP 格式：
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Profile with --inspect",
"program": "${workspaceFolder}/index.js",
"runtimeArgs": ["--inspect-brk"], // 必须加 -brk，否则 VSCode 连不上就直接跑完了
"console": "integratedTerminal"
}
]
}
然后在终端执行：node --inspect-brk index.js → 打开 Chrome chrome://inspect → 点“Record” → 导出 .cpuprofile → 拖进 VSCode 编辑器即可可视化。
Python py-spy 在 VSCode 里卡在 “Waiting for process…”？检查 PID 和权限
py-spy 是少数能真正在 VSCode 里一键 profile 的方案，但它依赖操作系统权限读取目标进程内存。Linux/macOS 上常因权限不足失败；Windows 上则可能被杀毒软件拦截。
- 确认目标 Python 进程正在运行：
ps aux | grep python，拿到真实PID - 不要用
sudo py-spy top --pid XXX—— VSCode 扩展无法继承 sudo 权限，应改用py-spy record -p XXX -o profile.svg手动生成，再用浏览器打开 SVG - VSCode 扩展
vscode-py-spy只支持通过python -m http.server启动的本地服务，不支持远程或容器内进程 - 如果用 conda/virtualenv，确保
py-spy安装在**同一环境**，否则符号表对不上，函数名显示为???
火焰图里一堆 [LazyCompile] 或 __libc_start_main？说明符号没加载全
这不是 VSCode 的锅，而是 profiler 采集时没附带足够调试信息。Node.js 火焰图中大量 [LazyCompile] 表示 V8 还没 JIT 编译完成就采样了；C++ 里满屏 __libc_start_main 说明没编译 debug info（-g）或 strip 过二进制。
实操建议：
- Node.js：加参数
--no-lazy强制预编译，再用--cpu-prof启动，生成的isolate-*.cpuprofile符号更完整 - C++：编译时务必加
-g -O0（开发期），发布前才切-O2；若用perf，需额外运行perf buildid-list -H && perf report --call-graph=dwarf - Python：
cProfile不显示 C 扩展耗时，想看 numpy/pandas 底层，必须用py-spy并确保安装时带--features speedscope
火焰图不是终点，而是起点——真正难的从来不是“看到哪个函数红”，而是判断它该不该优化、有没有锁竞争、是不是 I/O 等待伪装成了 CPU 占用。这些没法靠颜色深浅判断，得结合日志、系统指标、甚至重放请求路径。
