简介这份资源面向使用 IntelliJ IDEA 的 Java 开发者尤其适合刚接触 IDEA 或希望从 Eclipse 迁移、系统梳理常用配置的初中级程序员。内容围绕 2020.1.4 与 2022.2 两个版本均适用的配置技巧展开涵盖插件推荐、编码与字体设置、自动导包、自动编译、热部署、自定义缩写、快捷键与列模式编辑、界面优化以及配置导入导出等模块并附常见问题处理思路帮助读者减少重复设置、提升编码与调试效率。资源包共 1 个 docx 文档约 1.02MB以文字条目形式整理配置项与操作路径便于按需检索和对照调整。目前已有 479 人学习下载适合作为日常开发环境搭建与优化的参考清单。1. 从一台新装的 IDEA 说起2020.1.4 和 2022.2 到底该配哪些东西很多人拿到新电脑第一件事是装 IDEA第二件事是打开就写代码结果三天后开始骂娘中文乱码、Maven 拉不动、Git 提交慢、快捷键跟同事对不上。问题不在 IDEA 本身而在于你跳过了配置这一步。这篇笔记锁定的就是 IntelliJ IDEA 的常用配置覆盖 2020.1.4 和 2022.2 两个跨度不小的版本——前者是很多公司内网还在用的老版本后者是社区版下载量很大的一代两者在设置项位置、插件兼容性、编码默认值上都有差异。我下面讲的每一项都会标清楚哪个版本能用、哪个版本要绕路。适合谁看刚装完 IDEA 要跑 Java Web 项目的新人以及被编码、快捷键、插件折腾过的老手。配置这件事没有玄学只有没踩过的坑。2. 编码与文件模板乱码问题的根子在哪2.1 三个编码层级改错一个就白干IDEA 的编码设置分三层很多人只改了第一层然后发现控制台还是乱码。这三层分别是IDE 全局编码、项目编码、单个文件编码。2020.1.4 和 2022.2 的入口都在File | Settings | Editor | File EncodingsmacOS 是IntelliJ IDEA | Preferences但 2022.2 多了一个「Transparent native-to-ASCII conversion」的勾选项位置调整老版本在下方新版本挪到了右侧。需要改的四个值设置项推荐值说明Global EncodingUTF-8IDE 层面默认编码Project EncodingUTF-8当前项目编码Default encoding for properties filesUTF-8properties 文件专用Transparent native-to-ASCII conversion勾选让 properties 里的中文以 \u 形式存储最后一项是血泪经验不勾properties 里的中文在运行时可能变成问号勾了IDEA 会自动把中文转成 Unicode 转义读取时再转回来。2020.1.4 里这个勾选框在编码设置页底部2022.2 里它跟着 properties 那一行走找不到就往下滚。2.2 文件模板里预埋编码头省得每次手动加新建 Java 文件时自动带上author和编码声明靠的是 File and Code Templates。路径File | Settings | Editor | File and Code Templates | Includes编辑File Header/** * author ${USER} * date ${DATE} ${TIME} * encoding UTF-8 */${USER}取系统用户名${DATE}和${TIME}是创建时刻。这段头会插到每个新建 Java 文件顶部。注意 2022.2 里模板变量补全更智能输入${会弹候选列表2020.1.4 需要手打变量名打错了不会报错只是原样输出所以写完最好新建一个文件验证。2.3 控制台乱码的最后一公里即使上面全改了Tomcat 或 Spring Boot 启动时控制台仍可能乱码。原因是 JVM 默认编码跟系统相关。在 Run/Debug Configurations 里给 VM options 加一行-Dfile.encodingUTF-82022.2 还可以在Settings | Build, Execution, Deployment | Compiler | Java Compiler的 Additional command line parameters 里补-encoding utf-8。2020.1.4 没有这个 compiler 级别的编码参数入口只能靠 VM options 和 IDE 编码设置兜住。改完重启 IDEA别只重启应用IDE 缓存里的编码状态不重启不刷新。3. 快捷键与编辑器行为让手速跟得上脑子3.1 先选对 Keymap再谈自定义IDEA 自带多套 KeymapDefault、Eclipse、Visual Studio、NetBeans 等。2020.1.4 和 2022.2 的入口都在File | Settings | Keymap。如果你从 Eclipse 转过来直接选 Eclipse 方案能省掉大量肌肉记忆重建。但要注意Eclipse Keymap 下有些 IDEA 原生快捷键会被覆盖比如CtrlAltL格式化代码在 Eclipse 方案里可能变成别的。我一般建议先选 Default只改三五个最别扭的。改快捷键的方法是右键某个 action → Add Keyboard Shortcut然后按下你想要的组合。2022.2 会实时提示冲突2020.1.4 冲突提示没那么明显改完要去 Keymap 搜索框里搜一下新组合看有没有绑到别的 action 上。3.2 五个高频快捷键不设等于白装功能Default 快捷键说明全局搜索双击 Shift找类、文件、action最近文件CtrlE快速切回刚编辑的文件重构重命名ShiftF6改类名/变量名自动更新引用生成代码AltInsert生成 getter/setter/构造器格式化CtrlAltL按代码风格重排2022.2 里CtrlE的最近文件列表多了「最近修改」分组2020.1.4 只有按时间倒序的单一列表。这个差异不影响使用但如果你写文档截图给同事看注意版本不同界面不一样。3.3 编辑器行为里三个必调项File | Settings | Editor | General下面Auto Import勾选Add unambiguous imports on the fly和Optimize imports on the fly。2020.1.4 里这两个选项在 Auto Import 页顶部2022.2 挪到了同一页但分组更细。勾上之后写类名时 IDEA 自动补 import删代码时自动清理无用 import。Code Folding默认折叠 import、单行方法等。如果你习惯看全貌把One-line methods和Imports取消折叠。2022.2 新增了折叠区域预览鼠标悬停能看到折叠内容2020.1.4 没有。Save ActionsIDEA 没有内置保存时自动格式化需要装插件后面讲。但 2022.2 在Settings | Tools | Actions on Save里原生支持了「保存时优化 import」和「保存时重排代码」2020.1.4 只能靠插件。提示改完 Keymap 和 Editor 设置后导出一次配置File | Manage IDE Settings | Export Settings换电脑或重装时直接导入省得重配。2020.1.4 的导出入口在File | Export Settings路径不同但功能一样。4. 插件与 Maven/Git 配置2020.1.4 和 2022.2 的兼容分水岭4.1 插件市场里哪些值得装哪些会拖慢启动IDEA 插件装多了启动能慢一倍。我一般只留这几类Lombok2020.1.4 需要手动装插件并开启 annotation processing2022.2 内置了 Lombok 支持但如果你用的 Lombok 版本较老仍建议装插件并勾选Enable annotation processing路径Settings | Build, Execution, Deployment | Compiler | Annotation Processors。MyBatisX / MyBatis Log Plugin写 MyBatis 项目时跳转 XML 和接口2022.2 兼容性更好2020.1.4 建议用旧版本插件新版本可能不兼容。Rainbow Brackets括号着色读嵌套代码时有用。两个版本都支持。GitToolBox在编辑器里显示每行代码的 Git blame2022.2 上表现稳定2020.1.4 偶尔会卡顿如果卡就关掉 inline blame。不推荐装各种「AI 补全」插件在老版本上容易崩主题类插件除了好看没实际收益还有可能拖慢渲染。4.2 Maven 配置仓库地址和 JDK 绑定Maven 拉不动依赖九成是仓库地址和 JDK 没绑对。路径File | Settings | Build, Execution, Deployment | Build Tools | Maven。三个关键设置# Maven home path 指向你本地的 Maven 安装目录不要用 IDEA 内置的 # User settings file 指向 settings.xml里面配镜像仓库 # Local repository 指向本地仓库目录2020.1.4 和 2022.2 的 Maven 设置页布局基本一致但 2022.2 多了Use settings from .mvn/maven.config选项多模块项目里有用。另外Runner选项卡里的 VM Options 建议加-Dfile.encodingUTF-8 -Dmaven.wagon.http.ssl.insecuretrue第二项是跳过 SSL 校验内网仓库自签名证书时能救命。但注意这是降低安全性的做法只在确认内网仓库可信时用。4.3 Git 配置路径、编码、忽略文件File | Settings | Version Control | Git第一项是 Path to Git executable。2020.1.4 有时自动检测不到 Git需要手动指向git.exe或/usr/bin/git。2022.2 检测更准但如果你用 WSL 里的 Git仍需手动指定。Git 编码问题在项目根目录.gitconfig或全局配置里加[core] quotepath false [i18n] commitencoding utf-8 logoutputencoding utf-8quotepath false让 Git 显示中文文件名而不是八进制转义。这个配置跟 IDEA 版本无关但 2020.1.4 的 Git 集成对中文路径支持较差配了之后至少 commit 列表里能看清文件名。.gitignore建议在项目创建时就加IDEA 的.idea目录、*.iml、target、build都该忽略。2022.2 新建项目时会自动生成.gitignore2020.1.4 需要手动建。5. 避坑与排查那些让你怀疑人生的配置问题5.1 改了编码还是乱码现象File Encodings 全设了 UTF-8控制台输出中文仍是问号或方块。原因JVM 启动参数没带-Dfile.encodingUTF-8或者 Tomcat 的server.xml里 Connector 没设URIEncodingUTF-8。解决Run/Debug Configurations 的 VM options 加编码参数Tomcat 项目检查server.xmlSpring Boot 项目在application.properties加server.servlet.encoding.charsetUTF-8和server.servlet.encoding.forcetrue。5.2 插件装了但菜单里找不到现象在 Marketplace 里装了插件重启后找不到入口。原因插件与当前 IDEA 版本不兼容装上了但没激活。2020.1.4 对插件版本要求苛刻很多新插件标了「2021.1」就装不上。解决在Settings | Plugins | Installed里看插件是否标红或显示 incompatible。如果是去插件官网找历史版本或者用 2022.2 的「Install Plugin from Disk」手动装旧版。另一个原因是插件依赖别的插件比如某些主题插件依赖 Material Theme UI没装依赖就不显示。5.3 Maven 依赖下载卡在 resolving现象pom.xml 改完Maven 一直转圈或者报Could not resolve dependencies。原因仓库地址不通、镜像配错、或者本地仓库有损坏的.lastUpdated文件。解决先看settings.xml里的 mirror 是否指向可用仓库然后去本地仓库目录搜*.lastUpdated批量删掉最后在 IDEA 右侧 Maven 面板点刷新别用命令行mvn和 IDEA 混用两者可能读不同的 settings.xml。2022.2 的 Maven 面板多了「Reload All Maven Projects」按钮2020.1.4 只有刷新图标功能一样。5.4 快捷键冲突导致功能失效现象按了某个快捷键没反应或者触发了别的功能。原因Keymap 里同一个组合绑了多个 action或者被输入法、系统快捷键截胡。解决Settings | Keymap搜索框里直接按快捷键组合能列出所有绑定。冲突的右键 Remove 或改绑。系统层面Windows 的CtrlAlt方向键可能被显卡驱动占用macOS 的CmdSpace被 Spotlight 占用这些要在系统设置里改。5.5 2022.2 打开 2020.1.4 项目后配置丢失现象用 2022.2 打开老项目发现编码、Maven 路径、插件配置全变了。原因IDEA 的配置分「IDE 级」和「项目级」。项目级的.idea目录里存了编码、Maven 路径等但 2022.2 可能不认老版本的某些配置格式。解决不要直接打开先备份.idea目录然后用 2022.2 的「Open」选择项目根目录让 IDEA 重新生成配置。IDE 级的设置Keymap、插件在File | Manage IDE Settings | Import Settings里从老版本导出再导入。注意 2020.1.4 导出的 settings.zip 在 2022.2 里可能部分不兼容导入后逐项检查。6. 配置同步与版本迁移一次配好两个版本通吃配置这件事最烦的是换版本。我现在的习惯是把 IDE 级配置和项目级配置分开管理IDE 级用导出导入项目级用.editorconfig和 Maven/Git 的配置文件兜底。.editorconfig放在项目根目录IDEA 2020.1.4 和 2022.2 都原生支持root true [*] charset utf-8 end_of_line lf indent_style space indent_size 4 insert_final_newline true trim_trailing_whitespace true [*.md] trim_trailing_whitespace false这个文件的好处是不管谁用什么版本的 IDEA打开项目都按同一套编码和缩进规则走。2020.1.4 需要确认Settings | Editor | Code Style里勾了「Enable EditorConfig support」2022.2 默认开启。另一个技巧是 Settings Repository。2022.2 支持把配置同步到 Git 仓库换电脑时直接拉。2020.1.4 也有这功能但入口深在File | Settings | Tools | Settings Repository。配一个私有仓库把 Keymap、插件列表、编码设置推上去新机器登录同一账号就能拉下来。注意插件本身不会同步只同步插件列表新机器还是要重新下载插件。验证配置是否生效我一般做三个检查新建一个 Java 文件看文件头模板有没有生效在控制台打印System.getProperty(file.encoding)看是不是 UTF-8随便改一个快捷键重启 IDEA 看是否保留。三个都过这套配置才算落地。最后说个我自己的教训别在周五下午配环境。配置改崩了周末两天心里都挂着周一还得重来。配之前先导出一次当前设置改坏了能回滚。这个后悔药希望你用不上但一定要有。希望帮到你。本文还有配套的精品资源点击获取