前言今天不聊高并发、不聊架构设计想和大家聊一个每位Java程序员每天都在用的工具——IntelliJ IDEA。说实话用了多年IDEA我踩过不少坑。今天我把最经典的10个坑整理出来希望能帮大家少走一些弯路。很多小伙伴在工作中肯定也遇到过类似的问题比如“IDEA突然变卡了”、“代码明明没错就是编译不过”、“Debug的时候断点不生效”等等。这篇文章没有高深的理论全是实战经验小白也能看懂。希望对你会有所帮助。更多项目实战在我的技术网站susan.net.cn/projectIDEA的优缺点和使用场景在正式开讲之前我们先来客观地看一下IDEA这款IDE到底好在哪、不好在哪以及适合什么场景。IDEA的优点智能代码提示相比EclipseIDEA的代码分析引擎更强大能根据上下文给出更精准的补全建议。重构能力极强重命名、提取方法、改变签名等重构操作非常安全能自动修复所有引用。内置工具丰富版本控制、数据库客户端、HTTP Client、终端等一应俱全不用来回切换。插件生态完善Lombok、MyBatis、SonarLint等插件几乎覆盖了所有开发场景。调试功能强大条件断点、表达式求值、远程调试、内存分析等排查问题非常高效。IDEA的缺点内存占用较高默认配置下轻松吃掉2-4G内存老机器跑起来比较吃力。索引机制耗时每次导入项目或依赖变更都会触发重新索引大项目可能要等几分钟。配置相对复杂很多优化需要手动调整新手容易被各种设置搞晕。商业软件Ultimate版本收费虽然可以用Community版但很多企业级功能如Spring、JPA、JS等需要付费。适用场景场景是否推荐说明大型Java/Spring项目⭐⭐⭐⭐⭐IDEA的Spring支持无出其右中小型Web项目⭐⭐⭐⭐⭐开发效率远高于Eclipse多语言混合项目JavaJSPython⭐⭐⭐⭐⭐Ultimate版支持所有主流语言老旧机器内存8G⭐⭐勉强能用但建议升级配置或换VS Code纯前端项目⭐⭐VS Code可能更合适学生/开源学习⭐⭐⭐⭐Community版足够用好了了解这些背景之后咱们正式进入主题——我踩过的10个坑。第1个坑越用越卡CPU狂飙现象IDEA打开两三个小时之后敲个代码都要卡两秒鼠标转圈圈CPU动不动就100%。重启一下又好一会儿过一会儿又卡了。原因分析IDEA的卡顿通常有两个原因内存分配不足和索引被频繁触发。先说说内存。IDEA默认的堆内存只有512MB-1GB左右对于现代项目尤其是微服务项目一个workspace里有十几个module来说这点内存根本不够用。JVM频繁进行Full GC自然就卡了。再说说索引。IDEA会对项目中的所有文件建立索引以便实现快速搜索、跳转等功能。但是如果你开启了“自动索引外部文件”或者项目中有一个巨大的node_modules文件夹前端同学懂得IDEA就会一直尝试索引这些根本不需要索引的文件CPU直接拉满。解决方案第一步手动调整IDEA的内存配置。找到IDEA安装目录下的idea64.exe.vmoptions文件Mac在/Applications/IntelliJ IDEA.app/Contents/bin/idea.vmoptions修改以下参数# 建议配置8G内存机器 -Xms2048m # 初始堆内存建议直接给到2G -Xmx4096m # 最大堆内存给到4G -XX:ReservedCodeCacheSize512m # 代码缓存 -XX:UseG1GC # 使用G1垃圾回收器减少停顿 -XX:UseStringDeduplication # 去重字符串节省内存第二步排除不需要索引的目录。打开File - Settings - Project Structure - Modules把那些不需要索引的文件夹如node_modules、.git、target、build等标记为Excluded。做完这两步IDEA的流畅度会有一个质的飞跃。第2个坑getter/setter报红现象本来好好的项目更新了IDEA或者改了某个配置之后所有用Data、Getter注解的类的调用地方突然飘红编译失败提示“找不到getXxx方法”。原因分析Lombok的工作原理是在编译期通过注解处理器自动生成getter/setter等代码。IDEA需要安装Lombok插件才能识别这些生成的代码否则就会报红。这个坑通常发生在以下几种情况升级IDEA后旧版Lombok插件不兼容项目的Lombok依赖版本和插件版本不一致开启了IDEA的“注解处理”但没有正确配置解决方案第一步检查Lombok插件是否安装并启用。File - Settings - Plugins搜索Lombok确保已安装且勾选。第二步打开File - Settings - Build, Execution, Deployment - Compiler - Annotation Processors勾选“Enable annotation processing”。第三步确保项目的pom.xml或build.gradle中引入了Lombok依赖并且版本不要太老。推荐版本!-- Maven -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId version1.18.30/version scopeprovided/scope /dependency第四步如果上面三步都做了还是不行尝试File - Invalidate Caches and Restart清空IDEA的缓存并重启。这个操作能解决IDEA里80%的玄学问题。有一次我遇到一个特别诡异的情况同一个项目同事的IDEA没问题我的就是报红。最后发现是.idea目录下的配置文件冲突了删掉.idea目录让IDEA重新生成就正常了。第3个坑Debug断点死活进不去现象调试的时候我在一个Service方法的第一行打了个断点但是跑起来断点根本不生效代码直接执行过去了。更离谱的是有时候断点上的对勾是灰色的。原因分析这个坑有几种可能断点打在不可执行的代码行上比如接口的方法、空行、注释行。IDEA的断点只能打在可执行的字节码行上。开启了“静默断点”或“禁用所有断点”断点图标上有一个斜线表示暂时禁用。代码被JIT内联优化了在release模式下热点方法可能被内联导致断点位置和源码对应不上。多线程环境下断点被其他线程绕过了如果你打了条件断点且条件一直为false自然不会进去。解决方案首先检查断点图标。正常断点是红色圆点如果带斜线点击右键取消“Disable”。或者按Ctrl Shift F8打开断点管理面板看看是不是所有断点都被禁用了。其次确保断点打在可执行行上。比如// ❌ 以下位置不能打断点 public void doSomething() // 方法签名行 // ✅ 这样是可以的 public void doSomething() { System.out.println(这里可以打断点); // 第一行大括号后的有效代码 }第三如果是在多线程调试中检查一下条件断点。IDEA支持在断点上右键设置条件比如str null。如果条件永远不满足断点当然不会触发。第四终极方案使用Thread.currentThread().getStackTrace()打印堆栈来定位问题或者改用日志输出。第4个坑控制台中文乱码现象运行项目控制台打印的日志中中文全部变成了???或者\uXXXX这样的乱码。System.out.println(你好) 输出的是“???”。原因分析乱码的本质是编码不一致。IDEA的控制台、项目的源文件编码、JVM的默认编码、操作系统编码这四个地方只要有一个对不上就可能出现乱码。常见的情况是源文件是UTF-8编码但IDEA控制台用的是GBK或者反过来源文件是GBK控制台用UTF-8JVM的file.encoding参数没有正确设置解决方案第一步统一所有地方的编码为UTF-8。打开File - Settings - Editor - File EncodingsGlobal Encoding: UTF-8Project Encoding: UTF-8Default encoding for properties files: UTF-8勾选“Transparent native-to-ascii conversion”第二步修改IDEA控制台的编码。在Help - Edit Custom VM Options中添加-Dfile.encodingUTF-8 -Dconsole.encodingUTF-8第三步对于Maven项目在pom.xml的maven-surefire-plugin和maven-compiler-plugin中也指定编码properties project.build.sourceEncodingUTF-8/project.build.sourceEncoding project.reporting.outputEncodingUTF-8/project.reporting.outputEncoding /properties第四步如果用的是Logback或Log4j检查日志配置文件的编码比如Logbackappender nameCONSOLE classch.qos.logback.core.ConsoleAppender encoder pattern%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n/pattern charsetUTF-8/charset !-- 关键 -- /encoder /appender做完这些配置之后重启IDEA乱码问题一般就能解决了。第5个坑Git提交时多了.idea文件现象用IDEA自带的Git提交代码时Commit Changes窗口里总是出现一些不应该提交的文件比如.idea/workspace.xml、target/目录下的class文件、.iml文件等。有时候一不小心就提交上去了污染了Git仓库。原因分析IDEA默认会把项目的.idea目录和.iml文件纳入版本控制因为这些文件记录了项目的配置信息。但问题是这些文件里可能包含本地路径、个人配置等环境相关的信息不同机器之间不应该共享。target/目录是编译产物更不应该提交。根本原因是没有配置.gitignore文件或者配置了但IDEA没有正确识别。解决方案在项目的根目录下创建.gitignore文件把以下内容放进去# Compiled class file *.class target/ out/ # IntelliJ IDEA .idea/ *.iml *.iws *.ipr .idea/workspace.xml .idea/tasks.xml .idea/gradle.xml .idea/compiler.xml .idea/libraries/ # Log file *.log *.log.gz # OS generated files .DS_Store .DS_Store? ._* .Spotlight-V100 .Trashes ehthumbs.db Thumbs.db然后在IDEA中打开Settings - Version Control - Ignored Files确保没有任何冲突的规则。如果你的.gitignore文件已经在Git仓库中并且之前已经错误地提交了.idea目录需要先执行命令从Git缓存中移除git rm -r --cached .idea git commit -m Remove .idea from git之后再提交就只会看到需要提交的源码文件了。第6个坑Maven依赖下载巨慢现象在IDEA中刷新Maven项目Reload All Maven Projects时右下角一直在转圈下载依赖特别慢有时候直接超时报“Transfer failed”或者“Read timed out”。原因分析Maven默认的中央仓库在国外网络延迟大下载速度自然慢。IDEA虽然内置了Maven但默认会使用Maven自带的settings.xml其中没有配置国内镜像。另外IDEA的Maven和命令行Maven可能会共用同一个本地仓库~/.m2/repository如果同时操作会出现锁文件冲突。解决方案第一步配置国内镜像源。在File - Settings - Build, Execution, Deployment - Build Tools - Maven中找到User settings file点击“Override”然后选择或创建一个settings.xml文件填入以下内容?xml version1.0 encodingUTF-8? settings xmlnshttp://maven.apache.org/SETTINGS/1.0.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd mirrors !-- 阿里云Maven镜像 -- mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror /mirrors profiles profile idjdk-1.8/id activation activeByDefaulttrue/activeByDefault jdk1.8/jdk /activation properties maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target maven.compiler.compilerVersion1.8/maven.compiler.compilerVersion /properties /profile /profiles /settings第二步在Maven设置中把“Work offline”关掉除非你真的要离线工作把“Import Maven projects automatically”打开这样依赖变更时会自动下载。第三步如果你的网络环境特别差可以尝试配置IDEA的HTTP代理。Settings - Appearance Behavior - System Settings - HTTP Proxy如果公司有内网代理填进去即可。配置完成后点击Maven面板上的“Reload All Projects”按钮下载速度应该明显提升。第7个坑代码编译通过运行却报错现象在IDEA里Maven编译没有任何错误mvn clean compile也成功了。但是运行main方法或者启动Spring Boot时控制台报错java.lang.ClassNotFoundException: com.xxx.SomeClass。原因分析这个坑的原因很隐蔽IDEA的编译器和Maven的编译输出目录不一致。IDEA默认的编译输出目录是项目根目录/out/或者target/classes/而Maven的编译输出目录是target/classes/。如果你修改过项目结构或者IDEA的缓存乱了可能会导致IDEA运行时用的classpath里找不到某些类。另一个常见原因是使用了Lombok但是IDEA的注解处理器没有生成代码或者生成的代码路径不对。解决方案首先打开File - Settings - Build, Execution, Deployment - Compiler确保“Build project automatically”是勾选的但注意这会在你保存文件时自动编译对性能有影响。然后检查File - Project Structure - Modules看每个module的“Output path”和“Test output path”是否指向了正确的目录。一般来说Maven项目应该指向target/classes和target/test-classes。最暴力的解决方法点击Build - Rebuild Project清空所有编译输出然后重新编译。如果还不行执行File - Invalidate Caches and Restart清空缓存。还有一个绝招用Maven命令行先打包然后手动运行打好的jar包看是不是同样的问题。如果jar包能运行那就是IDEA的运行配置有问题如果jar包也报错那就是代码本身有依赖问题。第8个坑快捷键失灵现象习惯了用CtrlC、CtrlV复制粘贴代码突然有一天发现快捷键不管用了或者按下去之后出现奇怪的行为比如弹出某个面板、删除文字等。更离谱的是CtrlAltL格式化代码也无效。原因分析IDEA的快捷键冲突通常有两种情况与其他软件的快捷键冲突比如微信PC版的截图快捷键是CtrlAltA和IDEA的一些插件快捷键重复搜狗输入法的CtrlShiftF会切换简繁体。IDEA的keymap被无意中修改了可能是不小心按到了“切换keymap”的快捷键或者某个插件改动了设置。解决方案第一步检查是否切换了keymap。打开File - Settings - Keymap看看当前选中的keymap是不是你常用的比如Windows默认是DefaultMac是Mac OS X。如果显示Default copy或者别的说明被改过了。可以点击“Restore Defaults”恢复默认。第二步排查外部软件冲突。常见的冲突有微信CtrlAltW搜狗/微软拼音CtrlShiftF简繁体切换、CtrlShiftE表情QQCtrlAltA截图网易云音乐CtrlAlt上/下音量解决方法是去这些软件里修改快捷键或者直接关闭它们。我个人的习惯是写代码的时候把聊天软件退了清净。第三步如果只有某个特定快捷键失效可以在Keymap里搜索这个快捷键的动作看看是不是被占用了。比如搜索Reformat Code格式化代码默认是CtrlAltL如果显示多个动作说明有冲突可以右键移除一个。第9个坑连不上MySQL现象IDEA自带的Database工具很好用很多小伙伴可能不知道连接MySQL时报错The server time zone value ???ú±ê×??±?? is unrecognized或者Could not create connection to database server.原因分析MySQL 8.0以上版本要求明确指定时区参数serverTimezone。IDEA的Database连接配置默认不包含这个参数导致了错误。解决方案在IDEA的Database面板中点击数据源设置进入“Advanced”选项卡手动添加一个参数Name:serverTimezoneValue:Asia/Shanghai或者UTC如果还不行在“General”页面的URL后面直接加上jdbc:mysql://localhost:3306/test?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf-8另外如果是用Spring Boot项目的数据源配置也建议在连接池的URL中加入这些参数防止运行时报同样的错。最后检查一下MySQL驱动版本。IDEA默认会下载最新的驱动但如果你的MySQL是5.7版本用8.x的驱动可能会不兼容。可以在数据源的“Driver”下拉菜单中选择旧版本。第10个坑提交代码时自动格式化现象团队协作时你提交代码前IDEA自动帮你格式化了代码CtrlAltL。结果提交上去之后整个文件的缩进、换行、空行全变了。你的改动可能只有一行但是git diff里却显示了整个文件几百行的变更。代码Review的时候同事根本看不出你到底改了啥。原因分析这是IDEA的“崇高”功能——在提交代码时自动执行代码格式化、优化导入等操作。初衷是好的希望保持代码风格统一。但是如果团队成员没有使用统一的代码格式化规则比如每个人的缩进设置不同有的用4空格、有的用2空格、有的用Tab就会导致互相覆盖、diff爆炸。解决方案有两种解决思路方案一统一团队代码格式推荐在项目根目录下放置一个.editorconfig文件这是各大IDE和编辑器共同遵守的格式规范# .editorconfig root true [*] charset utf-8 indent_style space indent_size 4 end_of_line lf insert_final_newline true trim_trailing_whitespace true [*.java] indent_size 4 [*.xml] indent_size 2IDEA会自动识别.editorconfig并提示是否采用。这样所有人都用同一套规则。同时在IDEA中导出代码格式化规则File - Settings - Editor - Code Style - Java - Manage - Export把文件放进项目版本控制让同事导入。
