简介一份面向 IntelliJ IDEA 用户的常用配置整理适用于 2020.1.4 及 2022.2 版本主要解决开发环境定制、编码效率与插件选型问题。资源为单个 docx 文档压缩包仅 1.02MB已有 479 人学习。内容涵盖下载安装、插件推荐Maven Helper、Lombok、Grep Console、MyBatis LogFormat 等、基础设置编码、字体、自动编译、换行符、显示内存等并深入说明热部署配置、自定义缩写、类 Eclipse 快捷键与列模式编辑还整理了配置导入导出、文件夹颜色变化等细节与常见警告规避方法。文档按配置场景分类步骤要点简洁适合刚开始接触 IDEA 的新手快速上手也能帮助有经验开发者优化现有环境省去逐个摸索设置项的时间可作为日常配置时的参考手册。1. IDEA 常用配置先别急着写代码把默认值改掉一半再说一套配置不调,IDEA 2020.1.4 和 2022.2 的开箱体验其实相当一般默认字号偏小、提示区分大小写、热部署没开、自带的 Git 集成也不够顺手。真正拉开效率差距的从来不是 IDE 本身而是你愿不愿意花半天时间把配置改到位。这份配置笔记就是干这个的——从下载社区版开始到 12 个插件怎么选、基础设置每一项改什么值再到热部署、列模式、自定义缩写这些进阶操作全按 2020.1.4 和 2022.2 两个版本都能用为底线整理。适合刚接触 IDEA 的从业者也适合从 Eclipse 转过来的人照着一步步收尾。2. 版本、插件与构建工具社区版打底12 个插件按用途分四组2.1 版本与前置条件先用社区版JDK 和 Maven 就位再谈插件IDEA 官方下载地址是 https://www.jetbrains.com/idea/download/#sectionwindowsWindows 下提供社区版和付费的专业版。社区版免费日常 Java 开发、Spring Boot 项目都够用这份笔记里的所有配置在两个版本上的操作路径也基本一致唯一区别是 2022.2 之后部分菜单挪了位置后面会逐个指出来。下载时认准 Windows 下的 Community Edition 即可想要汉化界面的话直接在插件市场搜索 Chinese Language Pack 装上就行2020.1.4 和 2022.2 都能搜到。装完先别急插件把 JDK 和 Maven 配好才是前提。打开 File Project Structure SDK把本机 JDK 1.8 或 11 加进去再在 Settings Build, Execution, Deployment Build Tools Maven 里指向本地仓库和 Maven 安装目录。这两步不做好后面装再多插件项目编译都跑不起来。2022.2 的菜单入口在 File New Project 里选 Maven 原型时可以直接指定 JDK 版本但老版本还得在 Project Structure 里手动加。2.2 插件清单核心 12 个按界面、Git、Java 链路、路由四组装插件统一走 Settings Plugins Marketplace 搜索安装装完重启生效。给一张完整的清单表照着挑就行插件名称作用装完怎么验证生效Vuesion Theme换界面皮肤降低长时间盯屏疲劳安装后在 Settings Appearance Behavior Appearance 里选主题GitToolbox增强 Git 操作可视化查看提交历史、回退 merge打开 Version Control 窗口能看到多出的 Git Toolbox 面板Maven Helper在 pom.xml 里展示依赖树、排查冲突打开 pom.xml 底部出现 Dependency Analyzer 标签Search in Repository不需要浏览器就能查 Maven 坐标右键项目 Search in RepositoryGrep Console控制台日志染色错误和警告一眼区分运行项目后日志出现颜色Lombok编译期自动生成 getter/setter 等类里只写字段不写 getter代码能直接调用CodeGlance编辑器右侧显示代码缩略图编辑器右侧立刻出现细长缩略条Alibaba Java Coding Guidelines编码规范检查给出修改建议右键项目 阿里编码规约扫描MyBatis LogFormatMyBatis 日志拼成完整可执行 SQL控制台里的 SQL 日志变成完整占位符替换后的语句Rainbow Brackets嵌套括号按颜色区分代码里的圆括号、大括号自动变彩色RestfulToolkit根据 URL 反向找到 Controller 类按 CTRLALTN 输入 URL 直接跳类MyBatis XML and DAO JumpMapper XML 与 DAO 接口互相跳转在 DAO 方法旁边出现彩色跳转图标这几个插件真正解决的是日常开发里的高频痛点。Maven Helper 不是给你看坐标的是查冲突的多模块项目里版本被覆盖时它能直接列出谁引了哪个版本比人肉翻 pom 快得多。MyBatis LogFormat 属于“谁用谁知道”的插件日志里那种?占位符的 SQL 根本没法扔进 Navicat 跑它能把参数填回去生成一条可直接执行的完整 SQL排查数据问题能省一半时间。RestfulToolkit 适合维护老项目几千个接口按编号还是按功能找都麻烦直接 CTRLALTN 输入路径片段就能定位到对应类。GitToolbox 和 Search in Repository 属于偏效率的辅助插件前者把 cherry-pick、回退 merge 这些操作从命令行长确认变成可视化菜单后者解决“知道要用哪个依赖但记不清坐标”的翻浏览器问题。Grep Console 需要一句配置才更好用打开 Settings Other Settings Grep Console在 Highlighting 里给 ERROR 级别加一条正则规则我一般把^\d{2}:\d{2}:\d{2}设置成时间戳高亮日志时间轴一目了然。2.3 老版本装插件时的边界搜不到就手动下 zip别硬在 Marketplace 里翻2020.1.4 的插件市场接口和 2022.2 不完全一样部分近期更新的插件在老版本里直接搜不到这是插件市场兼容性导致的正常问题不是配置出错。处理办法是去 JetBrains 插件官网按版本过滤找到对应安装包下载 zip 后走 Settings Plugins 齿轮图标 Install Plugin from Disk。注意 2020.1.4 上装版本过新的插件可能出现菜单项缺失或启动时报错稳妥做法是选插件详情页里标了兼容 2020.x 的旧版本而不是强行装新版本。3. 编码、字体与性能基础设置的每一处都改到位3.1 统一编码与换行符先解决乱码和 git 误报Settings Editor File Encodings 是全国统一入口2020.1.4 和 2022.2 里路径没变。Global Encoding、Project Encoding、Properties Files 三栏全部改成 UTF-8Properties Files 那栏下面有个 Transparent native-to-ascii 选项也顺手勾上这样 properties 文件里写中文不会乱码。换行符是很多人踩坑的地方Settings Editor Code Style Line separator 里把值改成 Unix。Windows 默认的 CRLF 写出来的文件在 Linux 上跑或提交 Git 时经常出现只改了一行代码、git diff 却显示整个文件变红的情况。统一成 LF 之后跨平台提交不会误报。2022.2 新版本默认 Line separator 是 System但老项目里历史文件可能还是 CRLF改完设置后对历史文件手动做一次 File File Properties Line Separators Convert to LF 才彻底。3.2 字体、滚轮缩放与代码提示Settings Editor Font 里把字体换成 Consolas 或者 JetBrains Mono字号设到 14 到 16 之间这取决于屏幕分辨率别小看字号默认 12 号盯一整天眼睛真的很累。滚轮缩放功能在 Settings Editor General Change font size with CtrlMouse Wheel 勾上后面阅读大段代码时不用反复进设置。代码提示忽略大小写这一项在 Settings Editor General Code Completion 里默认的 Match case 是勾选的这意味着输入stringbuffer不会提示 StringBuffer输入system不会提示 System必须改成不勾选。两个版本这一项的位置完全一致改完立刻生效不用重启。3.3 编辑顺手些自动导包、行号、空格、隐藏 .idea 文件Settings Editor General Auto Import 里有三个选项重点是 Add unambiguous imports on the fly 和 Optimize imports on the fly 都勾上。前者在复制别人代码时自动补全 import不用手动逐条加后者在写完代码后自动删掉没用到的 import提交代码更干净。自动编译在 Settings Build, Execution, Deployment Compiler 里勾 Build project automatically这是热部署的前置条件后面第四章会用到。显示行号在 2022.2 新装后默认开但 2020.1.4 偶尔是默认关的去 Settings Editor General Appearance 勾 Show line numbers。空格与制表符的设置在 Settings Editor Code Style Java Tabs and Indents把 Use tab character 取消、Tab size 和 Indent 都设成 4然后在 Settings Editor General Appearance 里勾 Show whitespaces这样空格和 tab 会以点号显示出来排查缩进混乱问题直接用肉眼就能看出差异。隐藏 .iml 和 .idea 文件常见做法是在 Settings Editor File Types 右下角 Ignore files and folders 里把.idea;*.iml;追加进去文件树里立刻不显示这些配置文件项目窗口干净不少。注意这只影响当前 IDE 的显示不影响 git 提交仓库里还是建议把 .idea 和 *.iml 写进 .gitignore避免多人协作时配置冲突。3.4 编译、自动更新与内存显示顺手解决 IDEA 太卡的问题自动更新这个默认行为其实很打扰人Settings Appearance Behavior System Settings Updates 里把自动检查更新取消别让它在写代码时弹窗。新版本里还会默认下载一些没用的组件把 Automatically Install Updates 一并关掉。IDEA 占用内存高、CPU 跑满绝大多数时候不是软件本身的问题是堆内存给太小。先在编辑器里双击 Shift输入 show memory把 Show Memory Indicator 开关置为 ONIDEA 右下角出现内存指示条实时看到当前使用量。然后打开 Help Edit Custom VM Options老版本叫 Help Edit Custom VM Options2022.2 里在 Help 菜单下直接能找到把堆内存调大-Xms1024m -Xmx2048m -XX:ReservedCodeCacheSize512m -XX:UseConcMarkSweepGC -Dfile.encodingUTF-8常用参数解释-Xms是启动时预分配堆内存设成 1024M 避免运行中频繁扩容-Xmx是最大堆内存设 2048M 对普通单体项目足够内存 16G 以上的机器可以给到 4GReservedCodeCacheSize控制 JIT 编译缓存默认 240M 经常报不够导致频繁编译卡顿给到 512M 能明显改善打字卡JDK 11 以上可以不写 GC 参数老 JDK 8 建议保留第三行。这里多提一句改完 vmoptions 必须重启才生效如果改完 IDEA 打不开大概率是-Xmx给到了物理内存的一半以上把值降回去就好这是“idea 自动关闭”最常见的元凶。3.5 更新换行符与内存之后查看 IDAE 识别结果把上面这些设置全部做完后打开一个项目观察右侧内存条正常运行时稳定在 1G 左右说明配置起了作用。若还是卡下一个排查方向不是调更大内存而是去 Settings Plugins 里停用用不上的插件插件装太多对启动速度和输入响应的影响比内存还明显。4. 热部署、缩写与列模式进阶配置一次调顺4.1 热部署配置先开自动编译再去 Registry 里做手脚Spring Boot 项目改代码后手动重启是很多刚转 IDEA 的人最不习惯的一件事。IDEA 的热部署要三个条件同时成立才生效自动编译已经打开、Registry 里的编译开关打开、项目里有 spring-boot-devtools 依赖。自动编译在 3.3 节已经开了。剩下两步第一步按 CTRLSHIFTALT/ 打开 Registry2022.2 版本也可以在 Help Registry 打开搜索compiler.automake.allow.when.app.running把这个值从 false 改成 true。这一步解决的是“运行中修改代码不会触发编译”的问题不开它devtools 拿不到新的 class 文件自然也不会触发重启。第二步确认项目里有 devtools 依赖在 pom.xml 里检查这一段dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-devtools/artifactId optionaltrue/optional /dependency说下参数optional设为 true 不影响项目启动但会让打的包里不包含 devtools部署环境不会被热重启干扰devtools 默认的触发机制是 classpath 文件变化后自动重启实在不希望自动重启的可以在 application.yml 里加spring.devtools.restart.enabled: false改成手动触发。2022.2 新建的 Spring Boot 项目默认已经把 devtools 注释在 pom 里取消注释即可。实操有个细节修改 Controller 方法体内的代码、修改 Mapper XML、新增一个类三种变化热部署的响应速度不一样。改 XML 和改方法体最快新增类有时要等一两秒这属于 devtools 的 classpath 扫描机制不是配置失效。4.2 自定义缩写把 sout 改成 syso顺手加一组自己的从 Eclipse 转过来的人最难受的就是sysout打不出来。IDEA 默认的 System.out.println 是sout在代码补全里也找不到syso。位置在 Settings Editor Live Templates不是原文里说的 Code Completion这是在 Code Completion 里翻半天绝对翻不到的。在 Live Templates 里新建一个模板组加一个缩写为syso的模板内容写 System.out.println($END$);适用场景勾 Java 的 statement快捷键选 Tab 或 Enter。顺手把其他高频的也改掉psvm保留默认的 main 方法缩写foreach改成fofori改成fi一套改下来和 Eclipse 肌肉记忆完全对齐。注意每个模板都在 Java 的 context 里勾选适用的表达式否则在字符串里打字也会触发补全体验反而变差。4.3 列模式一个标准列一个不规则列两种都要会列模式解决的是多行相同位置的批量编辑。标准列模式是 ALT按住左键往下拉拉出的矩形区域内光标是同一列适合批量改行首、行尾、加注释。不规则列模式是 SHIFTALT左键逐个点击点哪哪出光标适合间隔选中几行的某段内容。2020.1.4 和 2022.2 的快捷键一致不用改。换个实际场景一个接口入参有 8 个 String 字段没用 final 修饰要求改成 final。用标准列模式 ALT 从第一行往下拖到第八行直接激活多光标然后输入final八行同时改完。更特殊的情况第 1 行在位置 10、第 3 行在位置 15这时 SHIFTALT 逐个点击对应位置再输入效果一样。需要注意的是出现中文输入法时列模式偶尔会失灵切换成英文输入法后再操作这是输入法和 IDE 快捷键冲突不是配置问题。4.4 Ctrl 快速访问列表 Quick Lists模拟 Eclipse 的按住 Ctrl 弹功能菜单Eclipse 老用户在类名或方法名上按住 Ctrl 再悬停会弹出一个可选菜单跳接口、跳实现类、看返回值IDEA 默认按住 Ctrl 直接跳转少了手选一步。想找回这个交互在 Settings Keymap 里点搜索框旁的齿轮选 Quick Lists新建一个名为 Switcher 的快速访问列表。然后在右侧把 Jump to Source跳实现类、Generate生成、Inspect Code 这些常用动作拖进去。给这个 Quick List 绑定一个不冲突的快捷键在 Quick Lists 面板里选刚建的列表按 AltEnter 设置键盘快捷键或者右键 add mouse shortcut 把中键绑定上。之后按住 Alt1或你设置的键访问列表基本找回 Eclipse 的 Ctrl 悬停手感。RestfulToolkit 的 CTRLALTN 按 URL 找类和这个搭配使用一个按路径反查一个按当前类动作切换互不干扰。4.5 文件夹变色注意新版只对已跟踪文件生效老版本里项目目录树里修改过的文件夹会整体变蓝一眼看出改动影响范围。新版本把这一行为改成了更细的粒度只对已经加入版本控制的、有改动的文件变色新增但未提交到 index 的文件不变色。新版这么改其实更准确但对于刚复制一份新模块进来的人会发现整个新目录静悄悄跟没复制进来一样容易误判。这个不用执着于改回旧版样式看文件变更的老老实实回 Version Control 窗口的 Local Changes 面板那里有完整的新增、修改、删除清单比目录颜色直观得多。5. 五个高频翻车点热部署失灵、CRLF 误报、字段警告、列模式冲突、换行误触发这一章把两个版本里最容易被问到的五个问题按“现象、原因、解决”理一遍都是我实际配过的坑。5.1 热部署不生效改了代码根本不重启现象是 Spring Boot 项目启动后在文件里加了日志语句控制台毫无反应必须手动点重启按钮。原因很直接Registry 里的compiler.automake.allow.when.app.running还是 false自动编译没触发devtools 等不到新的 class 文件自然不重启。解决的顺序有讲究先确认 3.3 节自动编译确实勾上了再 CTRLSHIFTALT/ 打开 Registry 把那个开关设为 true最后检查 pom 里 devtools 不是注释状态。三处缺一不可且修改完 Registry 要重启一次项目才生效。5.2 换行符 CRLF 导致整个文件 diff 飘红现象是 Windows 下从 Git 拉代码改了一行注释提交时 diff 里整个文件四五百行全变红。原因就是文件行尾是 CRLF和仓库里的 LF 不一致Git 把每个换行都算成一次修改。解决分两步全局把 3.1 节的 Line separator 改成 Unix然后对仓库根目录加一条.gitattributes规则强制文本文件统一 LF*.java text eollf *.xml text eollf *.yml text eollf解释下这段text表示该文件类型按文本处理eollf强制 Git 在提交和检出时都用 LF 换行。加了之后把本地文件重新git add --renormalize一次历史遗留的 CRLF 就彻底洗掉之后再改代码 diff 就是干净的。5.3 Private field is never assigned 警告Autowired 字段标黄现象是 Service 层的Autowired private UserMapper userMapper;一直显示黄色警告 Private field is never assigned。原因很简单IDEA 没有识别 Spring 的依赖注入机制它看到一个 private 字段从头到尾没有被显式赋值认为这是无效字段。解决有两步推荐先装 Spring 插件Settings Plugins 里安装 Spring 后会在项目文件上出现一个 Enable Spring 的工具栏托盘点一下开启 Spring 模型IDEA 能看到 Autowired 注入。如果项目里还有其他自定义注入注解再去 Settings Editor Inspections找到 Java Declaration redundancy Unused declaration在右侧忽略列表里把对应的注解完整类名加进去比如 Spring 之外的Resource。5.4 列模式按 ALT 拖不出多光标现象是 ALT按住左键往下拉拉出来的是矩形选区但光标只有一个没有多行同位置同时出现。原因大多是快捷键冲突某些插件的全局快捷键占了 ALT左键或者当前编辑器的选择模式处在整行选择。解决先看 Settings Keymap 右上角搜索Column Selection Mode把 Edit Column Selection Mode 的快捷键记下来按一次确保进入列选择状态然后再试 ALT拖动。还不行的去 Keymap 的搜索框输入altbutton3之类的键位组合把冲突项找出来改掉。5.5 右侧虚线变成强制换行现象是代码写长一点就自动断了明明自己没按回车。原因是在 Settings Editor Code Style 里设置了 Hard wrap at 后面的数值比如 120同时勾了 Wrap on typing。Hard wrap guide 是一条视觉参考虚线本来只负责显示边界但 Wrap on typing 会让代码在到达该值时自动换行。解决是把 Wrap on typing 取消勾选保留 Hard wrap guide 的显示这样虚线还在但写代码不会被打断。这个坑在老版本里特别隐蔽因为老版本默认 Wrap on typing 是开的2022.2 新版本才默认关掉。6. 换电脑不返工设置导出导入两个文件单独带走配置好的 IDEA 最怕换电脑重新来一遍好在 JetBrains 保留了完整的配置导出机制File Manage IDE Settings Export Settings2020.1.4 在 File Export Settings导出得到 settings.zip里面的范围包括界面外观、颜色方案、Keymap、代码风格、Live Templates还有 3.4 节改过的 vmoptions 相关选项的一部分。导入路径是 File Manage IDE Settings Import Settings或直接把 settings.zip 拷到新机后双击选择导入。但这里有个边界要知道settings.zip 不包含插件也不包含你单独改过的 Custom VM Options 文件。插件在新机上得重新从 Marketplace 安装所以导出前先在 Settings Plugins 里把已装插件列表截图留着或者直接按第 2 章的清单表重新搜一遍我都这么干。vmoptions 里改的内存参数属于安装目录和用户目录下的独立文件Windows 里一般在安装目录的 bin 下文件名类似 idea64.exe.vmoptionsLinux/macOS 在~/.config/JetBrains/IntelliJIdea2022.2/下迁移时顺手拷贝过去就行cp ~/.config/JetBrains/IntelliJIdea2022.2/idea.vmoptions /新机器对应目录/ cp -r ~/.config/JetBrains/IntelliJIdea2022.2/keymaps /新机器对应目录/第一条命令拷贝 VM 参数把 3.4 节设置的内存值带到新机器。第二条拷贝自定义键位因为部分键位绑定不会进 settings.zip 的导出范围尤其是通过第三方插件扩展出来的快捷键必须在插件装完后重新绑定。2022.2 新版本里 JetBrains 提供了 Settings Sync 选项登录账号直接云端同步配置和插件列表如果是自己个人项目、电脑数量不多比手动导 zip 省心多了。我自己的习惯是每年大版本升级前强制导出一份 settings.zip 放到工作目录的 docs 下换电脑、升级翻车、误改配置导致无法启动时都有后悔药。第一次没这么做从旧机器换到新机器对着截图重新配了四个小时后来就再也没有漏过导出。希望帮到你。本文还有配套的精品资源点击获取