快速清理入口
菜單欄 -> File -> Invalidate Caches / Restart...
-> 勾選所有選項 -> Invalidate and Restart
四大清理選項詳解
| 選項 | 清理內容 | 適用場景 | 耗時 |
|---|
| Clear file system cache and Local History | 文件系統緩存 + 本地歷史記錄 | 文件同步異常、外部修改未識別 | 快 |
| Clear VCS Log caches and indexes | 版本控制日志緩存索引 | Git/SVN 狀態顯示錯誤、提交歷史不全 | 中 |
| Clear downloaded shared indexes | 共享索引 (Maven/Gradle/JS庫) | 依賴解析失敗、代碼提示缺失 | 慢 (需重新下載) |
| Ask before downloading new shared indexes | 非清理項，行為設置 | 離線環境防止自動下載卡死 | - |
深度清理：手動刪除緩存目錄
Windows
%USERPROFILE%\AppData\Local\JetBrains\IntelliJIdea2023.2\caches
%USERPROFILE%\AppData\Local\JetBrains\IntelliJIdea2023.2\log
macOS
~/Library/Caches/JetBrains/IntelliJIdea2023.2
~/Library/Logs/JetBrains/IntelliJIdea2023.2
Linux
~/.cache/JetBrains/IntelliJIdea2023.2
~/.local/share/JetBrains/IntelliJIdea2023.2/log
# 安全刪除腳本 (關閉 IDE 後執行)
rm -rf ~/Library/Caches/JetBrains/IntelliJIdea*
rm -rf ~/.cache/JetBrains/IntelliJIdea*
常見問題對應清理策略
| 癥狀 | 推薦清理方案 | 說明 |
|---|
| 紅色報錯但代碼正常 | Invalidate Caches + Clear file system cache | PSI 索引損壞 |
| Maven 依賴不識別 | Clear downloaded shared indexes + Reimport | 共享索引版本不匹配 |
| Git 分支顯示異常 | Clear VCS Log caches | VCS 索引不同步 |
| 插件安裝後功能異常 | 完全退出 -> 刪除 caches 目錄 -> 重啟 | 插件類加載器殘留 |
| 項目打開極慢 | 刪除 .idea 目錄下的 caches 文件夾 | 項目級索引過大 |
預防性最佳實踐
- 定期清理：每月執行一次 Invalidate Caches
- 升級後必清**：IDE 大版本升級後必須清理
- 配置共享索引：Settings -> Build Tools -> Maven -> Indexing -> 勾選 "Update indexes on startup"
- 排除目錄：Settings -> Directories -> 標記
target/build/node_modules 為 Excluded
- 內存優化：
Help -> Change Memory Settings 分配 2-4GB 堆內存
對比：Eclipse Clean vs IDEA Invalidate
| 維度 | Eclipse Clean | IDEA Invalidate Caches |
|---|
| 觸發方式 | Project -> Clean | File -> Invalidate Caches |
| 清理範圍 | 工作空間構建產物 | 全局索引 + 項目緩存 + VCS 緩存 |
| 重啟要求 | 可選 | 必須重啟 |
| 影響面 | 單項目/工作空間 | 全局 (所有項目) |
