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`，添加/修改：

-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 时。