简介面向使用 IntelliJ IDEA 的 Java 开发者与需要统一开发环境的团队这份文档围绕 2020.1.4 与 2022.2 两个常用版本整理可直接落地的配置与优化清单重点解决插件选择、编码与编译设置、热部署、快捷键及常见警告等效率问题。压缩包内共 1 个 docx 文件大小约 1.02MB以图文步骤和配置项说明呈现便于按目录快速检索与对照操作。文档覆盖 Vuesion Theme、GitToolbox、Maven Helper、Lombok、Rainbow Brackets 等插件用途也包含文件编码、自动导包、显示空格、Unix 换行符、内存指示器、自定义缩写和导入导出配置等内容。已有 481 人学习适合希望减少重复设置、排查未使用字段警告并提升编码体验的初中级开发者参考。1. 换机器不重配一台 IDE 两套版本共用的配置基线新机器到手IntelliJ IDEA 装完第一件事往往不是写代码而是把编码、缩进、快捷键挨个改一遍改完发现漏了两项第二天又返工。我见过更狼狈的某开发者一台机器上同时装着 2020.1.4 和 2022.2社区版跑老项目、新版本看新框架两套配置各改各的提交上去的 properties 文件中文全变成问号排查了一下午才发现是编码设置只在一边生效。这份配置笔记的价值就在这儿——它不是某个版本的零散技巧合集而是一套跨 2020.1.4 和 2022.2 都能对上的配置基线覆盖插件、Settings 路径、热部署开关、快捷键复刻和配置迁移。适合刚从 Eclipse 转过来的人、需要在内网离线装插件的人也适合带团队、想把一套 IDE 习惯固化成可分发配置的人。2. 十二个插件分三组装从主题到 MyBatis 日志还原2.1 为什么按视觉、依赖、日志三组装插件装多了IDE 冷启动时间会明显拉长2020.1.4 在机械硬盘机器上尤其明显更麻烦的是功能重叠两个都改控制台输出的插件同时开着日志颜色会打架。我的习惯是按「解决哪一类问题」分组每组只留最能打的装完立刻验证一次效果验证不出来的当场卸掉。三组的划分是这样的分组插件解决的痛点装完怎么验证视觉层Vuesion Theme默认主题长时间看眼睛累配色对比度低重启后 Settings → Appearance 里能切主题视觉层CodeGlance长文件右侧没有缩略图定位靠滚轮瞎找编辑器右侧出现竖条缩略图视觉层Rainbow Brackets多层嵌套括号分不清哪对哪写三层以上 lambda 时括号自动分色视觉层Grep Console控制台一片白ERROR 和 DEBUG 混在一起控制台里 ERROR 行变红可选过滤级别依赖层Maven Helper依赖冲突只能靠mvn dependency:tree翻屏找pom 底部多出 Dependency Analyzer 标签依赖层Search in Repository查一个坐标要开浏览器搜Tools 菜单里能直接按关键字搜 GAV依赖层GitToolBox想知道某行是谁改的要开 blame 窗口光标停在行尾行尾显示提交人和时间规范层Alibaba Java Coding Guidelines命名、并发、集合用法全靠自觉右键菜单出现「编码规约扫描」规范层Lombokgetter/setter/构造器写一屏实体类上加Data不再报红日志层MyBatisLogFormat日志里 SQL 和参数分开打拼不出可执行语句控制台出现还原后的完整 SQL跳转层RestfulToolkit拿到一个 URL 找不到对应 ControllerCtrlAltN弹出 URL 搜索框跳转层MyBatis 相关跳转插件DAO 接口和 XML 之间来回翻文件接口方法左侧出现箭头图标可双向跳选型上有个朴素的判断标准一个插件如果不能用一句话说清「它替我省了哪一步操作」就不装。主题这类纯观感的插件装一个就够Vuesion Theme 之外再叠 Material Theme 只会让设置项互相覆盖。Maven Helper 和 Search in Repository 看似都跟 Maven 有关实际一个是分析已有依赖树、一个是查新坐标职责不重叠可以共存。2.2 在线装与离线装Marketplace 与 Install Plugin from Disk能连外网时走 Marketplace 最省事Settings → Plugins → Marketplace输入插件名点 Install装完提示 Restart IDE。一批插件可以连续装完再统一重启一次不用装一个重启一次。内网环境或者插件页打不开时走离线装。步骤是把插件 zip 包下到本地注意版本要和 IDE 主版本匹配2020.1.4 的插件包不能直接丢给 2022.2然后# 检查下载的插件包是否完整避免下到半截的 zip # 正常应该能看到 Zip archive data 开头 file ~/Downloads/plugin-name.zip unzip -l ~/Downloads/plugin-name.zip | head -20file命令确认它确实是 zip 而不是一个 HTML 错误页内网代理返回错误页时最容易出这种事unzip -l列出内部结构正常插件包根目录下应该有lib/和META-INF/plugin.xml。确认无误后在Settings → Plugins页面点齿轮图标选Install Plugin from Disk选中 zip重启。装完如果插件列表里看不到去Help → Show Log in Explorer翻idea.log搜索插件名常见报错是Plugin is incompatible with this installation意思是插件声明的since-build和当前 IDE 版本对不上。注意离线包一定要按 IDE 主版本分别准备一份。2020.1.4 对应的插件包在 2022.2 上装能装上但运行时会抛NoClassDefFoundError比装不上更难查。2.3 四个需要调参数才有价值的插件装完不调参数有些插件等于没装。Grep Console默认只按日志级别做基础着色实际项目里日志格式常常是自定义的。进Settings → Other Settings → Grep Console在 Expression 里自己加规则比如把包含TRACE的行压成灰色把带Dubbo字样的行标黄。规则是正则写.*ERROR.*和写ERROR效果不一样前者匹配整行、后者只匹配片段着色范围会不同。CodeGlance默认宽度 80 像素1080P 屏幕上偏窄看不清缩略图里的代码块分布。在Settings → Other Settings → CodeGlance把 Width 调到 110130同时关掉Disabled in distraction free mode之外的花哨选项。缩略图是实时渲染的文件超过五千行时会有轻微卡顿超大文件建议临时关掉。Maven Helper的核心价值在 pom 文件底部的Dependency Analyzer标签切到Conflicts页能看到所有冲突依赖红色标出被仲裁掉的那个版本。右键冲突项选Exclude它会自动往 pom 里补exclusion节点——这一步比手写 exclusion 靠谱因为手写容易漏groupId。MyBatisLogFormat用得上的前提是日志级别开到了 DEBUG且 MyBatis 的日志实现配的是 SLF4J 或 Log4j2。插件读取控制台里成对的Preparing:和Parameters:两行合并成一条带真实参数的 SQL。如果控制台只有Preparing没有Parameters去mybatis-config.xml里把logImpl显式指定或检查 logback 的 logger level 是不是被压到了 INFO。这类日志还原插件对 IDE 版本比较敏感2022.2 上装完如果菜单里找不到入口先在插件页看它的兼容范围说明别急着怀疑自己装错了。3. Settings 里那些默认值编码、缩进与换行符的六处必改3.1 编码三处对齐与 properties 的透明转换Settings → Editor → File Encodings这一页有三处编码Global Encoding、Project Encoding、Default encoding for properties files。三处全部设成 UTF-8少设一处就会出现「Java 文件正常、配置文件乱码」这种半好不坏的状态。2022.2 在这一页底部还多了个Default encoding for properties files的独立设置容易漏。真正让中文 properties 不乱码的是下面那个勾选框Transparent native-to-ascii conversion。勾上之后IDE 在保存时会把非 ASCII 字符自动转成\uXXXX转义读取时再转回来文件本身在十六进制层面是纯 ASCII任何环境下打开都不会乱。不勾的话文件按 UTF-8 存但很多老框架读 properties 时默认走 ISO-8859-1运行时中文就成问号了。提示这个勾选是「保存时转义」的行为对已经在仓库里的历史文件勾上之后要打开、随便改一下、保存才会真正转义。只勾不改旧文件的内容不会自动变。3.2 缩进、换行符与空白字符显示Settings → Editor → Code Style → Java → Tabs and Indents里四个数字要对上Tab size 4、Indent 4、Continuation indent 8、Label indent 0同时把Use tab character的勾去掉。用空格而不是 Tab 的理由很实际Git diff 里 Tab 和空格混用时改一个缩进层级整块显示为变更代码评审时看不出真实改动。换行符在同一个 Code Style 页面的Line separator下拉里选Unix (\n)。Windows 默认是 CRLF团队里有人在 Windows 提交、有人在 Linux 拉取脚本文件第一行会莫名多出一个\rshell 报bad interpreter。这个坑排查起来很费时间配一次能省很多事。空白字符显示在Settings → Editor → General → Appearance勾Show whitespaces。勾上之后空格显示为小点、Tab 显示为箭头缩进层级一眼可见。配合 4 空格设置能立刻发现从别处粘贴进来的 Tab 缩进代码。3.3 补全与编译大小写、自动导包、自动编译代码补全忽略大小写这项原文的描述是「去除勾选」逻辑上要绕一下Settings → Editor → General → Code Completion里的Match case勾选状态下输入小写string不会提示String取消勾选后才会大小写无关地匹配。2022.2 把这一项挪到了 Code Completion 页面下方且默认已经是取消状态从 2020.1.4 升上来的人往往以为设置丢了。自动导包在Settings → Editor → General → Auto Import两个勾都要打Add unambiguous imports on the fly负责在你敲完类名时自动补 importOptimize imports on the fly负责删掉不再使用的 import。第一个勾只对「无歧义」的类生效比如Date这种同时存在于java.util和java.sql的类IDE 不会替你猜得手动 AltEnter。自动编译在Settings → Build, Execution, Deployment → Compiler勾Build project automatically。这里有个容易被误解的点这个选项只在「没有程序在运行」时生效一旦你启动了 Spring Boot 应用改代码就不会触发编译热部署也就无从谈起。想让它运行态也编译得配合下一章的 Registry 开关。3.4 界面去噪行号、硬换行虚线、内存指示器行号在Settings → Editor → General → Appearance的Show line numbers。2020.1.4 开始这一项默认就勾上了从更老版本迁移过来的人会习惯性去找。编辑器右侧那条竖直虚线是硬换行参考线Show hard wrap guide取消勾选就消失。2022.2 里这一项改名为Show hard wrap and visual guides后面还跟着一个Configure…按钮可以细化到只显示缩进参考线。原笔记里记的是「去掉右侧竖直虚线」在新版本里对应的是同一个开关只是名字变了第一次找不到别以为设置没了。内存指示器用来观察 IDE 堆内存占用堆满了会卡顿。开关可以通过双击 Shift 搜索Show Memory Indicator打开也可以在Settings → Appearance Behavior → Appearance → Window Options里勾。打开后右下角显示形如512M of 2048M的数字前者是当前占用、后者是最大堆。如果经常跑到接近上限去Help → Change Memory Settings把上限调大改完需要重启。至于.iml和.idea目录Settings → Editor → File Types → Ignore files and folders里填*.iml;.idea;能让它们不参与索引和全局搜索但项目树里依然看得见。想真正从视图里消失得在项目树的齿轮菜单里把.idea标记为 Excluded。两件事不一样混起来会以为设置没生效。4. 热部署与快捷键Registry 开关、Eclipse 式 Ctrl 与列模式4.1 热部署的三个开关缺一个都不生效Spring Boot 项目的热部署很多人只做了第一步就以为完事结果改完代码纹丝不动怀疑是插件问题。实际要三个开关同时就位。第一步pom 里加 devtools 依赖scope 设成 runtime、optional 设成 true这样打包时不会带进生产包。第二步Settings → Build, Execution, Deployment → Compiler勾上Build project automatically。第三步最关键也最容易漏让 IDE 允许在程序运行期间自动编译。2020.1.4 走 Registry按CtrlShiftAlt/选Registry找到并勾上compiler.automake.allow.when.app.running。2022.2 里这个键在 Registry 中可能已经搜不到对应的入口挪到了Settings → Advanced Settings勾选Allow auto-make to start even if developed application is currently running。两个版本说法不同要做的事是同一件。Registry 里另外两个值顺手调一下更稳键建议值作用compiler.automake.allow.when.app.runningtrue运行态允许自动编译compiler.automake.postpone.when.idle.less.than0取消空闲延迟改完立即编译ide.instant.shutdowntrue关闭时不等后台任务减少卡死postpone这一项默认可能有几百毫秒的延迟改完代码立刻切浏览器看不到效果很多人误以为是热部署没生效其实是编译还没开始。注意devtools 的重启是「类加载器级重启」不是真正的零停顿热替换。改方法体通常能秒级生效改字段、加依赖、改注解配置往往还是得手动重启。这个边界要清楚别拿它当 JRebel 用。4.2 用 Live Template 把 syso 还给 Eclipse 迁移用户Eclipse 里syso加回车就展开成System.out.println()IDEA 里对应功能是 Live Templates不是代码补全。原文把入口写在 Code Completion 下那条路只能让候选列表里多一项敲完不会自动展开体验完全不同。正确姿势Settings → Editor → Live Templates点右侧加号新建一个 Template Group比如叫my再在该组下新建 Live Template。Abbreviation 填sysoDescription 随便写Template text 填System.out.println($END$);$END$是光标落点变量展开后光标停在这个位置直接敲要打印的内容。下方Define点开勾选Java → Statement勾 Java 也可以但作用域会大一些注释里也会触发。保存后回编辑器输入syso按 Tab或回车取决于By default expand with设置语句直接出来。同一套机制还能配一堆迁移友好型缩写main展开成public static void mainfori展开成带索引的 for 循环iter展开成增强 for。这些 IDEA 自带不用自己建值得自己建的是项目里高频的业务骨架代码比如一个带Transactional的 service 方法模板。4.3 Quick Lists 复刻 Eclipse 的 Ctrl左键Eclipse 里按住 Ctrl 把鼠标移到方法上会弹一个小菜单让你选「跳接口 / 跳实现 / 看返回值」IDEA 的 Ctrl左键默认直接跳声明跳错了要后退重来。Quick Lists 能把那个菜单复刻出来。先建列表Settings → Editor → Quick Lists点加号新建名字叫nav往里加四项——Declaration、Implementation(s)、Type Declaration、Super Method。这四项分别对应跳声明、跳实现、跳类型定义、跳父类方法。再绑快捷键Settings → Keymap搜索框输入列表名nav在结果节点上右键选Add Mouse Shortcut在弹出的对话框里把光标放进输入框按住 Ctrl 点一下鼠标左键。也可以Add Keyboard Shortcut绑一个组合键。这里有个必踩的坑Ctrl左键默认已经被Go to Declaration占用了绑的时候会弹冲突提示。要么先在 Keymap 里把Go to Declaration的左键快捷键删掉要么给 Quick Lists 换个组合比如CtrlAlt左键。删掉之后想跳声明用 Quick Lists 里的第一项功能不丢只是多一步选择。4.4 列模式与多点编辑批量改同列数据时列模式比正则替换安全得多。标准列模式是Alt按住左键下拉选出一块矩形区域输入的内容会同步写进每一行。写 SQL 批量加前缀、给一堆常量加引号这种活用它几十秒搞定。不规则列模式用ShiftAlt左键逐个点击目标位置每点一下加一个光标位置不用对齐。适合给若干不相邻的行尾统一加逗号或者给散落各处的变量名统一改名。2022.2 里ShiftAlt左键的行为是「添加光标」如果点下去没反应检查是不是被输入法或系统快捷键截走了。另外列模式在软换行开启时表现会错乱长行被折成多行显示后矩形选择的范围和视觉上的列对不上按CtrlShiftA搜Soft Wraps临时关掉再操作。5. 五个高频踩坑的排查顺序警告误报、热部署失效与内存条不显示5.1 properties 中文乱码改了编码也没用现象三处 File Encodings 全设成 UTF-8Java 文件正常但application.properties里的中文注释和值打开是问号重新保存后依然如此提交到仓库别人拉下来还是乱码。原因properties 文件的读写走的是Transparent native-to-ascii conversion这个开关控制的转义逻辑不是单纯的编码设置。这个勾不勾文件在磁盘上的字节完全不同。另外已经存在的文件不会因为勾上开关就自动重写。解决勾上Transparent native-to-ascii conversion然后逐个打开受影响的 properties 文件做一次「改一个字符再改回来」的保存动作让 IDE 重写文件。文件多的话用CtrlShiftA搜Convert to相关的批量转码动作或者在文件里全选剪切再粘贴触发一次完整重写。改完用git diff看一眼正常应该看到中文变成\u4e2d\u6587这种转义序列。5.2 热部署改完没反应控制台无重启日志现象devtools 依赖加了Build project automatically勾了改完 Java 方法体浏览器刷新还是旧逻辑控制台连一次重启记录都没有。原因八成是运行态自动编译没开。Build project automatically的生效范围仅限非运行状态程序跑起来之后 IDE 会主动跳过自动编译避免和运行时争抢文件。2020.1.4 需要在 Registry 里开compiler.automake.allow.when.app.running2022.2 在Advanced Settings里开对应项。解决按版本找到对应开关打开然后重启一次应用让配置生效——这个开关不会对已经在运行的进程即时起作用。验证方法是改一行System.out观察控制台是否出现Restarting due to X class path changes之类字样。如果还是没有检查 devtools 的 scope 是不是被设成了provided之外的奇怪值以及 IDE 的自动编译是否被省电模式关掉了右下角有个小人图标省电模式下一切后台编译停止。5.3 Lombok 装了插件还是全红现象插件市场里 Lombok 显示已安装、已启用实体类上Data也不报错但所有getName()、setName()调用点全红编译能过IDE 报找不到符号。原因Lombok 依赖注解处理器在编译期生成代码IDE 要识别这些生成的方法必须开启注解处理。装插件只是让 IDE 认识Data这个注解本身两件事是分开的。2022.2 起 Lombok 的部分支持已经内置但注解处理开关依然是独立的。解决Settings → Build, Execution, Deployment → Compiler → Annotation Processors勾上Enable annotation processing。2020.1.4 里这一页可能还要指定Store generated sources relative to为Module content root。勾完执行一次Build → Rebuild Project让处理器重新跑一遍红色才会消失。如果开了之后仍然红去Settings → Build, Execution, Deployment → Compiler → Java Compiler确认Use compiler选的是 Javac 而不是 Eclipse 编译器后者对 Lombok 的支持要额外配置。5.4 Ctrl左键绑了 Quick Lists跳转反而失灵现象按上一章的方法把Ctrl左键绑给 Quick Lists绑完发现按住 Ctrl 点方法名既不弹菜单也不跳转偶尔还会跳到奇怪的父类上去。原因快捷键冲突没有真正解决。IDEA 允许同一个组合键存在多个绑定冲突时按注册顺序或作用域决定谁生效表现就是「有时灵有时不灵」。Go to Declaration在编辑器作用域里优先级更高把鼠标事件吃掉了。解决Settings → Keymap里搜Go to Declaration右键Remove CtrlButton1 Click或改成别的组合再回来确认 Quick Lists 的绑定是唯一持有者。改完点右下角Apply不用重启。改完如果 Quick Lists 弹出来但选项是灰的说明当前光标位置不在方法或类上把光标放到方法名中间再试。5.5 内存指示器开了却不显示现象双击 Shift 搜到Show Memory Indicator并打开右下角依然空空重启 IDE 也没用。原因这个开关的作用位置是状态栏右侧而 2022.2 之后状态栏的显示项可以被主题或插件接管。装了改状态栏样式的主题插件时指示器会被挤掉。另一种情况是搜到的那个动作只是临时切换没有写进配置。解决走正式入口Settings → Appearance Behavior → Appearance → Window Options勾Show memory indicator点Apply。如果勾上后仍不显示把主题插件临时禁用重启验证。确认是主题冲突后在主题设置里找状态栏相关选项或者换一个不接管状态栏的主题。5.6 .idea 加到忽略列表项目树里还在现象Ignore files and folders里填了*.iml;.idea;全局搜索确实搜不到.idea里的内容了但项目树里那个目录还杵在那儿看着碍眼。原因Ignore files and folders管的是索引和搜索不影响项目视图的显示逻辑。项目树显示什么由 Project 视图的选项和目录的 Excluded 标记决定。解决在项目树里选中.idea目录右键Mark Directory as → Excluded图标变橙色但它还在。想彻底从视图里去掉点项目树右上角齿轮把Show Excluded Files取消勾选。注意 Excluded 的目录不参与索引如果哪天需要在.idea里改个配置得先把标记取消掉。另外.iml文件本身建议直接写进.gitignore# 仓库根目录的 .gitignore挡住 IDE 元数据 .idea/ *.iml *.ipr *.iws out/ target/这几行挡住的是提交不是显示。团队里每个人都配一次比在群里反复提醒「别把 .idea 提交上来」有效得多。6. 配置导出与团队落地一份 settings.zip 的验证清单配置调舒服之后最实际的问题是把它搬到另一台机器。2020.1.4 的入口在File → Import Settings/File → Export Settings2022.2 收进了File → Manage IDE Settings子菜单功能一样位置变了第一次找会愣一下。导出时勾选要带的项插件本体不会打进包里只有插件列表所以新机器上仍然需要重新装插件。导入有个顺序问题值得记一笔先导配置、再装插件。反过来的话某些插件在导入配置时会用自己的默认值覆盖掉你刚导进来的设置项。导完不要立刻开工按下面这张清单过一遍检查项预期结果不对时看哪里File Encodings 三处全部 UTF-8Settings → Editor → File Encodingsproperties 转义勾选状态同上底部勾选框Line separatorUnix (\n)Settings → Editor → Code StyleLive Template syso输入能展开Settings → Editor → Live TemplatesQuick Lists 快捷键无冲突标记Settings → Keymap搜列表名自动编译与运行态编译两个都是开Compiler 页 Advanced Settings关键插件已装且已启用Settings → Plugins → Installed比导入导出更稳的做法是把跟项目强相关的规则从 IDE 配置里剥离出来落到仓库里的.editorconfig。它是跨编辑器的谁用什么 IDE 都读同一份规则也不会因为某人忘了导入 settings.zip 就破坏缩进# 放在仓库根目录IDEA、VS Code、Vim 都会读这份规则 root true [*] charset utf-8 end_of_line lf insert_final_newline true trim_trailing_whitespace true indent_style space indent_size 4 # 配置类文件按两空格缩进跟社区惯例对齐 [*.{yml,yaml,json}] indent_size 2 # Markdown 的行尾空格有语义不能自动裁掉 [*.md] trim_trailing_whitespace falseroot true表示向上不再查找父级配置避免被用户目录下的全局配置污染end_of_line lf和前面 Code Style 里的 Unix 换行是同一件事的两个入口.editorconfig优先级更高会覆盖 IDE 里的个人设置。这套东西配合 settings.zip 一起用个人习惯跟着人走项目规则跟着仓库走两边不打架。我自己的后悔药是每次换机器或者升级大版本都不急着写业务代码先拿一个已有的小项目跑一遍上面那张清单重点是热部署和 Live Template 两项——这两项失效时不会报错只会让你在改了十几次代码都没生效之后才发现问题。踩过一次改完代码刷新浏览器十分钟没反应的坑从那以后我每次升级 IDE 都强制走一遍这份清单五分钟换一整天心安。希望帮到你。本文还有配套的精品资源点击获取