1. updating indices 到底是什么为什么它总在折磨你先说实话updating indices 这个提示几乎每个用 IntelliJ IDEA 的开发都见过。但你越急它越转项目越大它越慢甚至有时候你刚打开 IDE 想去改一行代码它就是卡在那转圈圈鼠标点哪儿都没反应。我最早接触 IDEA 是几年前从另一个 IDE 转过来的第一感觉就是“这个 ide 怎么这么重”后来才明白它不是重是它没搞清楚什么该索引、什么不该索引。updating indices 翻译过来就是“更新索引”。IDEA 会对你打开的项目做一次扫描把文件、类、方法、字段、引用关系全部建立成索引。你可以把它理解成给一本书做目录文件越大、章节越多做目录的时间自然就越长。IDEA 靠这一套索引才能实现秒开的类跳转、全局搜索、自动补全和重构。所以索引本身不是坏东西它是 IDEA 高效工作的基础。但问题是很多人把项目打开后索引一直转不完甚至十几分钟都在 updating indices这就很难受了。导致这个问题的原因多半不是 IDEA 本身不行而是你没有告诉它哪些目录值得索引哪些目录压根不用管。IDEA 很实诚你给它一个项目它默认会扫描整个项目结构包括 node_modules、target、build、.idea 这些目录这些目录动辄几万甚至几十万个文件里面存的全是依赖、编译产物、临时文件索引它们除了让 CPU 狂转、让进度条走不完之外没有任何好处。身份识别上也容易出问题。从老版本升级到新版本索引格式可能完全不兼容IDEA 会强制重来一遍。换了一个 Git 分支代码结构变了相关文件的索引也要更新。还有的人喜欢把项目放在机械硬盘上或者放在公司网盘映射的本地目录里文件监听文件变动都慢半拍索引自然也跟着慢。一句话总结updating indices 慢不是玄学是索引对象太多、索引条件太差、索引缓存失效太频繁。下面我一个个说怎么治。2. 对症下药把 updating indices 彻底降速的方案2.1 先把不需要索引的目录全部排除掉这招的效果最立竿见影。你不用创建新项目直接对现有项目做一次“瘦身”。在 IDEA 里最简单的办法是右键点击项目目录选择 Mark Directory as然后选 Excluded。如果是 Maven 项目target 目录一般会自动标成 Excluded但并不是所有构建工具和所有版本的 IDEA 都这么智能。我见过不少项目打开后还是把 build、out、dist、node_modules 这些目录纳入索引的。手动排除目录的操作路径是这样的打开 Project 工具窗口找到项目根目录在目录上右键选择 Mark Directory as - Excluded如果有多个模块每个模块下的 target、build、out、.gradle 等目录都建议检查一遍排除了之后IDEA 就不会再给这些目录建索引搜索和跳转也都会自动忽略它们。要注意的是Excluded 不是删除只是让 IDEA 在工作区里无视它构建工具依旧可以正常读写这些目录。所以你可以放心大胆地操作。如果你想要更精准的控制可以打开 Project Structure快捷键 CtrlAltShiftS在 Modules 面板里每个模块的 Sources 和 Excluded 标签页都可以精细调整。我一般习惯把项目的每个子模块都过一遍保证没有漏网之鱼。除了手动排除IDEA 还提供了一个全局配置Settings - Editor - File Types在这里可以配置忽略文件和文件夹比如可以添加.class、.jar、.git、node_modules 等。不过我个人觉得这个全局配置在部分老版本里效果不如 Excluded 直观建议两个配合使用。2.2 缓存清理的正确姿势Invalidate Caches 与本地历史有时候索引慢并不是因为项目大而是因为缓存坏了。比如 IDEA 突然断电、强制退出或者硬盘空间不够导致缓存写入失败都有可能出现索引一直重复构建、进度条走到一半就卡死、或者明明没改代码却反复触发 updating indices 的怪现象。这时最简单粗暴的办法就是 File - Invalidate Caches。弹窗里会提供几个选项Invalidate and Restart清空索引并重启最彻底优先用这个Clear file system cache and Local History清理文件系统缓存和本地历史但保留索引一般用于缓存异常但不是索引问题的情况如果你只是想释放磁盘空间不愿意重建索引可以去掉下方跟索引相关的勾选项我推荐遇到索引问题先选 Invalidate and Restart。虽然重启后第一次打开项目会重新建索引但是这次重建是干净的没有垃圾数据干扰速度反而比你在脏缓存上反复重试更快。清理完缓存之后再结合排除目录索引速度会有质的提升。另外一个很多人不知道的点IDEA 的 Local History 是个好东西但日志积累多了也会拖慢性能。Local History 默认保留 5 天文件改动频繁的项目会积累大量历史快照。如果你从来不用这个功能可以在 Settings - Appearance Behavior - System Settings - File History 里把它关掉或者调整保留天数。这个操作能减少不小的 I/O 压力。2.3 针对超大项目的进阶方案划分模块和拆分索引如果你的项目实在太大比如几十个模块的微服务工程、或者一个仓库里塞着前端和后端的所有代码即使排除了 target 和 node_modules索引量还是很大。这时就得从项目结构上想办法。首先检查一下项目里是否存在根本不需要的模块。很多工程是从老仓库迁移过来的里面的老模块已经废弃了但还在 pom.xml 或 settings.gradle 里挂着。这些模块会照常被 IDEA 加载和索引。正确的做法是从构建配置里移除掉废弃模块或者在 Project Structure 里把这些模块直接删掉。这样不但更新索引快IDEA 整体的内存占用也会降下来。其次你可以把工程量大的仓库拆分成独立项目打开而不是全部塞进同一个窗口。比如一个仓库里既包含用户端服务、管理端服务又包含公共 SDK如果它们之间没有强依赖完全可以分别用 IDEA 打开而不是强行放到一起。IDEA 虽然支持多模块项目但跨多个独立仓库时用多个窗口反而更流畅。还有个偏门但有效的方法直接用 IDE 的 Trusted Project 机制。新版 IDEA 在打开项目时会让你选 Trust Project 还是 Dont Trust选择 Trust 之前IDEA 会执行一次项目加载。如果你经常打开不信任来源的项目建议在 Project Structure 里明确源文件目录减少无意义的全局扫描。其实这本质上还是在帮 IDEA 缩小它需要关心的范围。2.4 排除目录时需要注意的几个坑排除目录听起来简单但有几个地方容易踩坑。第一个坑是某些构建工具在重新导入项目后会把之前排除的目录重新标记回普通目录。比如 Maven Reload Project、Gradle Sync 之后Source 目录和 Excluded 目录会被构建工具重新读取并覆盖。所以这不是一劳永逸的每次 Reload 完之后最好再检查一遍。第二个坑是如果你把某个包含源码的目录也排除了IDEA 的代码搜索和跳转就会失效。我见过有人图省事直接把整个 build 目录甚至把某个模块的 src 给误排除了导致整个模块的代码全部变成灰色类跳转全部失败。排查了半天才发现是排除范围大了。第三个坑是node_modules 这种目录一定要优先排除。前端项目在 IDEA 里的加载速度很大程度就取决于你有没有排除 node_modules。一个 node_modules 可能包含几万个包、几十万个文件IDEA 要对每个文件建立索引的话进度条转几个小时都不奇怪。提示排除目录之后如果代码搜索找不到某些类先检查是不是排除范围太大而不是一上来就重建索引。3. 缓存空间修改别再让 C 盘被 IDEA 撑爆3.1 IDEA 的目录到底是怎么组织的IDEA 的缓存和配置不是放在项目目录里的它有一个独立的系统目录。以 Windows 为例默认情况下IDEA 会把配置放到C:\Users\你的用户名\AppData\Roaming\JetBrains\IntelliJIdeaxxx把缓存放到C:\Users\你的用户名\AppData\Local\JetBrains\IntelliJIdeaxxx。注意这两个路径不一样。Roaming 路径下放的是配置、插件、日志Local 路径下放的是缓存、索引、临时文件。其中 Local 路径里的index、caches、tmp这几个文件夹是最占空间的。我见过一个项目特别多、索引特别大的开发机光 IDEA 的缓存目录就能占到 10 个 GB 以上。如果 C 盘本来就只有 128G 或者 256G 的固态那就非常痛苦了。所以定期查看这两个目录的大小很有必要。在 IDEA 里打开 Help - Show Log in Explorer可以快速定位到日志目录日志目录就在系统目录下。你可以顺着路径找到整个 JetBrains 目录看看占用空间。3.2 修改系统目录到其他盘符的详细步骤IDEA 支持自定义系统目录路径最简单的方式就是通过 Help - Edit Custom Properties 来修改。操作步骤打开 IDEA进入 Help - Edit Custom Properties如果提示创建 properties 文件选择 Yes在打开的文件中添加以下几行配置idea.system.pathD:/idea-data/system idea.config.pathD:/idea-data/config idea.log.pathD:/idea-data/log这里我建议把三个目录全都指向同一个新目录下的不同子目录后续找文件也方便。路径根据自己的实际盘符和目录调整。保存文件重启 IDEA。重启之后新生成的配置、日志、缓存就全都会写到 D 盘了。但是要注意旧目录里的缓存不会自动搬过去。你需要手动把C:\Users\你的用户名\AppData\Local\JetBrains\IntelliJIdeaxxx下的index、caches等文件夹复制到新路径下或者干脆让它重新生成一遍。如果你不想要旧数据直接删掉旧目录也行IDEA 会自动创建新的。这里还有一个细节通过 Edit Custom Properties 修改的是配置文件IDEA 在下次启动时才会读取。如果你等不及可以直接修改 IDEA 安装目录下的idea.properties文件但我不推荐这么干因为版本升级时安装目录下的文件可能被覆盖而且权限控制更麻烦。用 Edit Custom Properties 生成的文件位于配置目录下升级时不受影响。修改好系统目录后建议重启 IDEA 并打开一个项目确认状态栏不再出现异常再考虑清理旧目录避免风险。3.3 缓存目录迁移常见的坑和验证方法缓存目录迁移完之后有几个检查点第一重启 IDEA 后去 Help - Show Log in Explorer确认路径已经变成你指定的新路径。如果还是老路径说明配置没生效。第二项目打开速度、索引速度如果没有明显变化先别急着怀疑迁移失败。缓存目录迁移的主要作用是把占用空间从 C 盘转移到其他盘对性能的提升不一定有立竿见影的效果但可以避免 C 盘满了导致的系统卡顿。第三不要在 IDEA 运行状态下直接删除旧缓存目录。如果你删除了正在使用的缓存IDEA 可能因为文件消失而崩溃或者重新索引。先退出 IDEA再清理。第四很多人在用双系统或者多人共享电脑时用户名里有中文或者空格这样某些老版本工具处理不了。如果你遇到奇怪的问题可以试试把自定义路径设置为纯英文路径。3.4 定期清理缓存脚本与手动方案迁移完目录后缓存还是会持续增长。为了不让自己某天突然收到“C 盘不足”的警告我建议定期清理或者写一个小脚本。IDEA 缓存目录里最值得清理的是index和caches。这两个文件夹删除后IDEA 会重新索引项目虽然第一次有点慢但能释放大量空间。操作时先退出 IDEA然后手动删除这两个文件夹再启动 IDEA 让它重新生成即可。如果你习惯用脚本可以写一个简单的清理脚本比如把D:/idea-data/system/index和D:/idea-data/system/caches下的 30 天前的文件清理掉。不过脚本要注意别误删系统目录同时做好日志记录。注意不要直接删除整个system目录最好只清理index和caches子目录其他目录比如plugins、projects里存的东西删了可能引发别的问题。4. 日常设置让 IDEA 在性能体验上更顺手4.1 内存调优给 IDEA 分配多少内存才合适IDEA 本身是 Java 写的JVM 的堆内存设置直接决定了它的流畅程度。很多人默认不管结果 IDEA 在项目大的时候频繁卡顿、甚至直接报 OutOfMemoryError。其实 IDEA 提供了图形化的内存调整入口。打开 Help - Change Memory Settings可以直接修改 IDEA 的最大堆内存。默认情况下IDEA 会根据系统总内存自动分配一个值但有时候这个值对大型项目来说不够。如果你打开一个几十个模块的 Maven 项目又同时开几个微服务IDEA 的堆内存占用很容易超过 2GB。我自己的建议是在 16GB 内存的机器上给 IDEA 分配 2GB 到 3GB在 32GB 内存的机器上可以给到 4GB。但注意不要无脑调大因为堆内存越大GC 暂停越明显反而可能更卡。除了 Change Memory Settings 之外还可以通过修改 JVM 参数文件进一步调优。找到 IDEA 安装目录下的idea64.exe.vmoptionsWindows或者idea.vmoptionsmacOS、Linux修改以下几个参数-Xms2048m -Xmx4096m -XX:ReservedCodeCacheSize1024m-Xms是初始堆大小-Xmx是最大堆大小ReservedCodeCacheSize是 JIT 编译后代码缓存的保留空间。这几个参数设置好之后重启 IDEA 生效。为什么要关心 GC因为 IDEA 在更新索引、编译、代码检查时会产生大量短命对象如果堆太小频繁的 Minor GC 会让你感觉 IDEA 一卡一卡的。如果你对 JVM 调优不熟只需记得一句话给 IDEA 的初始堆和最大堆设成相同值可以减少堆扩缩容带来的卡顿。4.2 关闭不用的插件插件是性能的隐形杀手插件装多了IDEA 启动会变慢后台分析和索引也会变慢尤其是那些会在后台定时扫描代码的插件比如代码规范检查、定时任务的插件每来一轮工作CPU 占用就飙升。新版 IDEA 启动经常出现企业级激活码、云开发等插件如果不用完全可以禁用。在 Settings - Plugins 页面里找到 Installed 标签把不用的插件点 Disable甚至 Uninstall。我常推荐禁用或慎重安装的几类插件云开发插件如果不用云服务完全没必要装数据库插件如果项目不涉及 DB或者你习惯用独立的数据库客户端可以直接禁用重量级框架插件如果项目不用 Vaadin、JavaFX 等框架装了纯属浪费内存主题类和工具类插件大多数对性能没有任何帮助保留一些核心插件是必要的因为 IDEA 很多功能都依赖插件实现。但你要有意识地管理插件数量。我见过一台开发机上装了 80 多个插件启动时间拉长到 5 分钟后台随时烫手。禁用掉不必要的插件之后启动时间几乎减半。4.3 关闭自动更新和文件监听减少后台突发负载IDEA 默认会自动检查更新每次启动可能都会连接官网。这个功能看似无害但在一些网络条件不好的场景下会造成 IDEA 启动时变得很慢因为它在后台做网络请求。如果你的 IDE 版本稳定建议直接关掉。在 Settings - Appearance Behavior - System Settings - Updates 里把 Automatically check updates 关掉即可。这样 IDEA 启动时就不用做网络请求响应会更快。文件监听也是一个隐藏的性能消耗点。IDEA 会监听项目文件的变化一旦文件系统有大量文件变动比如 Git 切换分支、Maven 重新下载依赖、 build 工具生成大量临时文件IDEA 就会触发重新扫描和索引。这些监听是有代价的。在 Settings - Appearance Behavior - System Settings 里可以调整“Synchronize files on frame activation”等选项。如果你经常切分支可以在 Git 操作完后稍等一下别急着切来切去让 IDEA 有时间完成后台任务。4.4 编码、自动导入、外观等其他实用设置日常开发里还有一些细节能显著提升使用体验。编码格式统一很重要。在 Settings - Editor - File Encodings 里把 Global Encoding 和 Project Encoding 都设置为 UTF-8。否则项目里有繁体中文、日文、韩文文件时IDEA 有概率乱码严重的甚至影响索引和搜索。自动导入建议开启。在 Settings - Editor - General - Auto Import 中勾选 Add unambiguous imports on the fly 和 Optimize imports on the fly。这样写代码时就会自动补 import而且会顺手清理多余的 import保持代码整洁。字体和编辑区行为也可以调一下。在 Settings - Editor - Font 中设置你习惯的字体大小同时在 Settings - Editor - General - Mouse Control 里勾选 Change font size with CtrlMouse Wheel以后就可以用 Ctrl滚轮调节字号演示和截图时也方便。对于新版 IDEA如果你不喜欢全新的 UI可以在 Settings - Appearance Behavior - Appearance 里切换回旧版 UI。新版 UI 确实更现代但在小屏幕上并不一定更好用选自己顺手的就好。5. 出问题怎么排查几个常见场景和解决记录5.1 索引速度依然慢怎么办如果你把排除目录、清理缓存、调大内存都做了索引速度还是慢那问题可能出在更底层。第一项目是否放在机械硬盘或者网络磁盘上。IDEA 对文件系统随机读性能非常敏感机械硬盘上索引一个中等大小的项目速度可能比固态硬盘慢四五倍。建议把项目放到本地固态硬盘尽量别放在公司映射的网盘上。第二杀毒软件或系统安全工具是否在后台扫描项目文件。Windows 的 Defender 有时候会在文件变动时逐个扫描文件这会和 IDEA 抢磁盘 I/O。你可以在杀毒软件里把 IDEA 安装目录和项目目录加为信任区。这项工作要专业谨慎千万别因为设置错误导致系统安全出现漏洞建议按官方文档操作。第三日志里是否有大量报错。打开 Help - Show Log in IDEA查看idea.log如果有大量的大堆栈异常那可能是某个插件崩溃导致索引反复失败。5.2 迁移缓存目录后打不开项目有时候改了系统目录之后IDEA 重开反而报错或者之前的项目列表消失。这是比较常见的问题原因多半是 config 路径里没有把原来的 keymaps 和模板配置迁移过去。解决方法也很简单把旧系统目录下的config/options、config/templates等关键文件夹复制到新路径或者直接把旧 config 里的内容整体复制过去。如果你嫌麻烦最稳妥的办法是迁移前先使用 File - Manage IDE Settings - Export Settings 导出一份配置迁移后再用 Import Settings 导入。5.3 到底要不要用 Invalidate Caches多久能重建完Invalidate Caches 不是万能药它只治“索引数据损坏”这种病如果你的索引慢是因为项目太大、目录没排除到位、内存不够那清缓存只会让你把痛苦的第一次建立索引过程再经历一遍。所以我的建议是先做排除目录和调内存最后再清缓存。不要一上来就 Invalidate Caches有时候你会发现自己白等了几分钟。常见的索引问题排查顺序可以参考这个表现象优先排查方向建议手段索引进度条一直卡住是否有超大目录未排除检查 target、node_modules、build每次打开项目都会索引缓存损坏或路径异常先迁移目录再 Invalidate Caches索引速度时快时慢后台插件或系统 I/O 占用关闭无用插件检查杀毒软件索引过程内存飙升JVM 堆太小或插件过多调大 -Xmx禁用非必要插件索引正常但代码跳转失败排查排除范围是否过广打开 Project Structure 检查标记5.4 两个容易被忽略的日常习惯我想额外提醒两件事。第一不要同时在一个 IDEA 窗口里打开特别多项目。IDEA 虽然支持多项目在同一窗口打开但多个项目共享同一份内存和索引会互相拖慢。我见过有人一个窗口同时开着五六套系统索引跑起来 CPU 直接打满。第二定期重启 IDEA。这个建议听起来很土但很管用。IDEA 长时间运行后JVM 里的对象碎片、文件句柄、插件缓存都会累积表现出来就是越用越卡。每天上班打开 IDEA中午吃饭或者下班前顺手重启一次很多疑难杂症就直接消失了。6. 我踩过的坑和一点个人心得最后分享几个我自己的真实经验。有一年我在做一套微服务重构项目仓库里塞着 40 多个模块还混着两个前端项目。IDEA 打开一次要转好几分钟索引每次切换 Git 分支都要等半天。我原本以为是无解的后来花了半小时把 module 梳理了一遍排除了所有不需要建索引的目录又把缓存目录迁走索引时间从五分钟降到了四十秒整个人的心情都变好了。还有一次IDEA 突然卡在 updating indices 上不动清理缓存也没用。最后发现是我前一天把项目放到桌面上的一个同步网盘目录里了网盘客户端一直在后台同步文件导致文件系统频繁变动IDEA 的索引被反复无效化。把项目移出同步目录之后问题秒解。所以如果你的项目放在各种网盘同步目录里请务必迁出来。IDEA 不是越新越好也不是功能越多越好。它只是一个工具你的目标是让它在你自己的机器、自己的项目上跑得最顺。多花一点时间配置好排除目录、缓存位置和内存参数后面每天写代码的体验都会舒服很多。如果你照着上面的方法调完updating indices 还是慢那就在项目打开的时候先干点别的比如看需求文档等它慢慢索引。要真急就用 2.2 的 Invalidate Caches再结合 2.1 的排除目录重新来一遍。
