在 Debian 上提升 PhpStorm 代码补全速度
一 调整代码补全触发与范围
- 缩短弹出延迟：进入 Settings/Preferences > Editor > General > Code Completion，将 Autopopup documentation in (ms) 与 Autopopup code insight window after typing 从默认 500 ms 调整为 200–300 ms，既快又不至于频繁打扰。
- 保持自动提示开启：勾选 Show suggestions as you type，确保边写边出提示。
- 排序策略取舍：若更看重“稳定即见”，可取消 Sort suggestions by relevance（按相关性排序），改为按字母顺序展示，减少计算开销。
- 补全范围要全：确认包含 SmartType、Class names、Symbols；PHP 开发可开启 Include non-imported classes，减少“没 use 就没提示”的情况。
- 手动触发兜底：习惯键位 Ctrl + Space 强制唤起补全，确保关键时刻不漏提示。
二 减少索引与插件开销
- 清理与重建索引：执行 File > Invalidate Caches / Restart，重建索引以消除碎片和旧缓存带来的迟滞。
- 排除无需索引的路径：将 vendor/、node_modules/、storage/、cache/、dist/ 等构建产物或第三方依赖加入 Settings > Project Structure > Excluded，避免无谓索引。
- 精简插件：在 Settings > Plugins 禁用与当前项目无关的插件（如多余框架、数据库、云服务插件），降低内存与 CPU 占用。
- 控制文件监听：减少不必要的文件状态监听与第三方工具集成，降低文件系统事件压力。
三 优化 JVM 与内存参数
- 编辑 VM 选项：在 PhpStorm 安装目录 bin/ 下修改 phpstorm64.vmoptions（或 phpstorm.vmoptions）。
- 合理堆内存：将 -Xms 与 -Xmx 设为合适值，例如 -Xms512m -Xmx2048m（依据机器内存与项目体量调整，避免过大导致 GC 停顿或过小频繁扩容）。
- 代码缓存与 GC：可设置 -XX:ReservedCodeCacheSize=512m，并选用 G1 GC（如 -XX:+UseG1GC）以在高并发索引/补全时获得更可预期的停顿。
- 变更前先备份原始 vmoptions 文件，便于回滚。
四 系统与 I/O 层面的优化
- 使用 SSD：将项目与 IDE 安装目录放在 SSD 上，I/O 提升对索引与补全的响应最明显。
- 轻量桌面环境：在资源紧张时可切换到 XFCE/LXDE 等轻量桌面，减少系统层竞争。
- 保持更新：升级 Debian 稳定版与 PhpStorm 至较新版本，获取性能修复与索引优化。
- 外部工具替代：将耗时任务（如 代码格式化、静态分析）交由 Prettier、ESLint 等外部工具，减轻 IDE 负担。
五 5 分钟快速检查清单
- 在 Editor > General > Code Completion：延迟 200–300 ms；勾选 Show suggestions as you type；按需关闭 Sort suggestions by relevance；确认包含 SmartType/Class names/Symbols；PHP 开启 Include non-imported classes。
- 排除 vendor/、node_modules/ 等目录，执行一次 Invalidate Caches / Restart。
- 禁用不常用插件，减少索引与内存压力。
- 适度提升 -Xmx/-Xms，并启用 G1 GC。
- 项目与 IDE 放在 SSD，保持系统与 IDE 为最新稳定版。
