PhpStorm 保存卡顿主因是 onSave 后台任务阻塞主线程，需关闭 Settings → Editor → General → Actions on Save 中非必要项、拼写检查的“Check spelling on save”、ESLint/Prettier 的自动运行及文件同步选项。
PhpStorm 保存文件时卡顿，大概率不是磁盘或内存问题，而是「保存前自动触发的后台任务」在阻塞主线程。最常踩坑的是开启但未调优的格式化、拼写检查、代码检查（Inspection）和文件同步逻辑。
为什么 onSave 格式化会卡住 UI
默认启用 Reformat code on save 时，PhpStorm 会在每次 Ctrl+S 后完整解析当前文件 AST、应用规则、重写文本——对含大量注释、复杂数组结构或嵌套 JSON 的 PHP/JS 文件，耗时可达 300–800ms，且期间编辑器完全无响应。
- 该行为与你是否安装 Prettier/ESLint 无关，是 PhpStorm 原生格式化引擎（Code Style）触发的
- 即使关闭了所有第三方插件，只要勾选了
Reformat code on save或Optimize imports on save，就可能卡 - 若项目启用了
php-cs-fixer或eslint --fix的 onSave 集成，会叠加延迟，且错误不会报在 UI，只出现在Event Log里
拼写检查（Typo）在保存时偷偷扫描全文
PhpStorm 默认对所有字符串字面量、注释、甚至 HTML 属性值启用拼写检查，且 Check spelling on typing 和 Check spelling on save 是两个独立开关——关掉前者，后者仍可能生效。
- 拼写检查使用本地词典 + Levenshtein 距离匹配，对长文本（如 Markdown 文档、大段 SQL 注释）会造成明显延迟
- 它不显示进度条，也不进后台线程，直接跑在 EDT（事件调度线程），导致“按完 Ctrl+S 后鼠标指针转圈 2 秒”
- 路径
Settings → Editor → Proofreading → Typo里的Check spelling on save必须手动取消勾选
如何精准关闭卡顿源而不影响日常开发
不要一刀切禁用所有检查，只需停掉保存瞬间真正拖慢你的那几个：
立即学习“PHP免费学习笔记（深入）”；
- 进
Settings → Editor → General → Actions on Save，**只保留**Update copyright notice（如果你用它），其余全部取消勾选 - 进
Settings → Editor → Inspections，点击右上角Configure inspections→ 选中Spellchecking→ 取消勾选Run inspection when saving files - 若用 ESLint/Prettier：进
Settings → Languages & Frameworks → JavaScript → Code Quality Tools，把Run automatically on save改为On explicit action only - 检查
Settings → Build, Execution, Deployment → Console → Shell是否勾选了Sync files on frame activation——这个选项会让保存后强制触发一次文件系统同步，尤其在 NFS 或 WSL2 挂载目录下极易卡死
容易被忽略的隐藏开关：文件监听与外部工具链
保存卡顿还可能来自“你以为关了，其实没关”的联动机制：
-
Settings → Appearance & Behavior → System Settings → Synchronization中的Synchronize files on frame activation和Save files on frame deactivation会影响保存行为的触发时机，建议全关 - 如果项目配置了
Deployment → Options → Upload changed files automatically to the default server，保存即触发上传——哪怕你没改远程配置，只要勾选了就会走 FTP/SFTP 协议握手，超时默认 5 秒 - 某些老旧插件（如早期版本的 Laravel Plugin、PHP Annotations）会在
beforeSave阶段注入钩子，不报错但阻塞流程；可临时进Help → Diagnostic Tools → Debug Log Settings，加日志组com.intellij.openapi.fileEditor.impl.FileDocumentManagerImpl查看保存前最后执行了哪些 listener
真正卡住保存的，往往不是大功能开关，而是几个默认开启、又藏得深的“微小同步动作”。关掉它们比调 JVM 内存见效更快——因为问题根本不在资源不足，而在任务串行阻塞。
