pycharm专业版右键函数名选“profile”可直接启动内置性能分析器，适用于可运行脚本的cpu密集型瓶颈定位，但不支持community版、纯模块文件及异步代码深度分析。
右键函数名选“Profile”是最直接的方式
PyCharm 内置的 Profiler 不需要额外安装或配置，只要你的代码能正常运行，就可以对任意可执行入口（比如 main()、app.run() 或某个 WebSocket 处理函数）直接右键 → 选择 Profile。它会自动启动带采样的运行流程，并在结束后弹出分析窗口。
注意：这个功能只在 PyCharm Professional（专业版）中可用；Community 版不支持，强行右键没有该菜单项。
- 必须是可运行的 Python 脚本（含
if __name__ == "__main__":或 Flask/FastAPI 启动逻辑） - 不能对纯模块文件（如
utils.py）直接 Profile，得找一个调用它的入口点 - 如果项目用了虚拟环境，PyCharm 会自动使用当前配置的解释器，无需手动切换
运行后看懂 “Time(ms)” 和 “Own Time(ms)” 这两列
性能分析窗口默认显示四列：Name、Call Count、Time(ms)、Own Time(ms)。关键不是总耗时最长的函数，而是 Own Time(ms) 高且调用次数少的函数——说明它自身做了大量计算，没把时间花在子调用上。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
-
Time(ms)是函数从进入、执行所有子函数、到退出的总耗时（含子函数） -
Own Time(ms)是函数体内部代码执行时间（不含子函数），更反映“真瓶颈” - 双击
Name列中的某行，PyCharm 会跳转到对应源码位置，方便定位 - 点击
Call Graph标签页，能看清谁调用了谁、每层花了多少时间
Profile 异步代码（如 FastAPI WebSocket）要小心挂起
PyCharm 的内置 Profiler 对 async 函数支持有限。如果你 Profile 一个 @app.websocket("/ws") 函数，它可能卡在 await websocket.accept() 上，因为 Profiler 默认不识别异步事件循环挂起状态，会误判为“卡死”或提前结束采集。
- 推荐改用
yappi：它专为异步设计，支持 asyncio 和 uvloop - 不要在
async def里直接调用yappi.start()，需确保在 event loop 启动后、实际业务逻辑前开始采样 - 避免 Profile 整个服务器启动过程（如
uvicorn.run()），应聚焦在 handler 内部逻辑段 - 如果坚持用 PyCharm 内置 Profiler，建议先用同步 mock 替换掉
await调用，测通路逻辑再逐步放开
别依赖“一键 Profile”覆盖所有场景
内置 Profiler 适合快速定位 CPU 密集型瓶颈（比如数据处理、循环计算），但对 I/O 等待、内存泄漏、GIL 争抢、协程调度延迟等问题基本无感。比如你看到 requests.get() 耗时 2s，Profiler 只会把它记作 2s 的“own time”，但无法告诉你这 2s 是网络延迟、DNS 解析、还是服务端响应慢。
- 网络/数据库耗时多的场景，优先加日志打点或用
time.perf_counter()手动包住关键段 - 怀疑内存问题？用
tracemalloc或 PyCharm 的Memory View（需开启 Memory Profiling 插件） - 想看每行执行耗时？
line_profiler比内置 Profiler 更细，但要手动装饰函数 - Profile 结果受运行时负载影响大，单次结果参考价值有限，建议多次运行取中位数
真正难的不是怎么点开 Profiler，而是读懂它没告诉你的那部分——比如为什么 Own Time 很低但整体响应很慢，这时候就得跳出 Profiler，去看网络、磁盘、锁、甚至 Docker 容器资源限制。
