PyCharm 卡顿排查与修复(2026-08-11)
PyCharm 2024.1 打开项目后持续卡顿,UI 无响应,编辑延迟明显,新电脑虽然是轻薄本但项目本身并不大不应该会这样。项目目录仅 378 个文件(排除 venv_BA 后),排除 venv_BA 和 __pycache__ 后仍然卡,说明不是文件索引问题。
根因定位:
查看 %LOCALAPPDATA%\JetBrains\PyCharm2024.1\log\idea.log,发现:LowMemoryWatcher: Low memory signal received: afterGc=true
每 1--2 秒触发一次,说明 JVM 堆内存不足,GC 疯狂回收,CPU 全耗在垃圾回收上。
当前配置:`-Xmx2048m`(堆上限 2GB),PyCharm 进程实际占用 2.8GB,已超出堆上限。
修复:Help → Edit Custom VM Options`,添加/修改:
bash
-Xmx4096m
-Xms512m
重启 PyCharm 即解决。
补充
如果你的pycharm是非正版安装(破解版激活),可能会出现在pycharm中修改但实际并未修改的情况,可以手动打开C:\Users\..\AppData\Roaming\JetBrains\PyCharm2024.1\pycharm64.exe.vmoptions进行更改(记得显示隐藏文件),依然是增加上面两行,之后重启pycharm解决。
辅助优化
-
`File → Settings → Appearance & Behavior → System Settings → Data Sharing`:取消勾选 `Send usage statistics`,避免生成 10MB/个的 `open-telemetry-metrics` CSV 日志
-
右键 `venv` 目录(自己命令行创建的虚拟环境可能会反复扫描) → `Mark Directory as → Excluded`
教训
> PyCharm 卡顿不要只怀疑文件太多或索引问题,先查 `idea.log` 中的 `LowMemoryWatcher`。堆内存不足是高频卡顿的常见根因,尤其当内存上限 ≤ 2GB 时。