1. 动手之前:先把版本和环境这盘棋想明白
IDEA2023 指的是 JetBrains 在 2023 年发布的 IntelliJ IDEA 三个大版本(2023.1、2023.2、2023.3),它是目前 Java、Kotlin、Spring 生态里使用面最广的集成开发环境。很多人拿到安装包就直接双击下一步,装完发现卡顿、乱码、依赖拉不下来,再回头重装一遍,时间全耗在返工上。我自己带过几批新人,也帮同事处理过几十次环境问题,最后发现八成的毛病都出在"装之前没想清楚"这一步。这篇内容会把 IDEA2023 的安装、初始化配置、常见故障排查完整走一遍,适合刚入行的新手,也适合想把自己那套老环境重新整理一遍的老手。
先说清楚这篇东西的边界:它讲的是一条正经路子——官方渠道拿安装包、合理规划磁盘和内存、按项目类型配好 JDK 和构建工具。至于网上到处流传的各种"优化包""修改版",我不会写,也不建议你去碰。原因很简单:IDE 是要读你全部源码、连你数据库、拿你 Git 凭证的工具,装一个来路不明的东西进去,等于把钥匙交给陌生人。授权这件事后面单独一节讲,学生会、教师、开源项目都有正规的免费路径。
1.1 2023 这几个小版本,到底差在哪
JetBrains 一年发三个大版本,2023.1、2023.2、2023.3 的差异不像名字看起来那么小。2023.1 最大的动作是新 UI 的预览版上线,同时把 Java 20 的语言特性支持补齐;2023.2 把新 UI 变成了默认界面,老界面需要在设置里手动切回去,同时加入了对 Java 21 的初步支持和内置的 AI Assistant 预览功能;2023.3 则把 Java 21 的支持做到了完整,虚拟线程调试、记录模式的语法高亮这些都能正常识别了。
对绝大多数人来说,我的建议是:如果你要做 Java 21 的项目,直接上 2023.3;如果只是维护 Java 8/11/17 的老项目,2023.1 和 2023.2 完全够用,而且插件兼容性更好。插件生态有个滞后期,新版本出来时总有些小众插件还没跟上,尤其是公司内部自研的插件。我们团队当时就遇到过一次——升级到 2023.2 之后,一个内部代码检查插件直接报错,最后是回退到 2023.1 等了两周。
另外要提醒一点:不要把 2023 和 2024 混淆。有人搜到"2023 版本"结果装了 2024.x,然后发现某些插件行为不一样,白白浪费时间对不上号。版本号在Help > About里能看,一眼就能确认。
| 版本 | 关键变化 | 适合人群 |
|---|---|---|
| 2023.1 | 新 UI 预览、Java 20 支持、Maven 导入提速 | 项目偏保守、依赖内部插件的人 |
| 2023.2 | 新 UI 默认、Java 21 初步支持、AI Assistant 预览 | 想尝鲜新界面、项目在 Java 17 的人 |
| 2023.3 | Java 21 完整支持、虚拟线程调试优化 | 用 Java 21 新特性的人 |
1.2 硬件底账:别让电脑先拖后腿
IDEA 这东西对机器是有要求的,官方给的最低配置看起来很友好(8G 内存、2 核 CPU),但那是"能打开"的标准,不是"能干活"的标准。我实测下来,一个中等规模的多模块 Spring Boot 项目(20 个模块左右),索引阶段峰值内存能吃到 3G 以上,如果同时开着数据库工具窗口、几个微服务同时跑,8G 机器基本就是在拿命换。
我自己给身边人的推荐配置是这样:16G 内存起步,SSD 必须,CPU 四核以上。如果预算有限只能上 8G,那就要接受频繁的 GC 卡顿,并且必须把内存参数调低、把不需要的插件关掉,后面我会讲怎么压榨。还有一个很容易被忽略的点——磁盘空间。IDE 本体大概 2~3G,但缓存目录(索引文件、日志、插件下载)通常在用户目录下,一个大项目索引下来能到 2~5G。C 盘只剩几 G 的人装完必炸,这不是危言耸听,我见过不止一次 C 盘被索引文件撑爆导致系统卡死的。
系统方面:Windows 10 64 位以上(Win7 已经不被支持了),macOS 需要在受支持的系统版本上,主流 Linux 发行版都没问题。特别提醒 Apple M 系列芯片的用户:2023 版本已经全面提供原生 ARM 构建,下载时一定要选对架构,用 Intel 版本跑在 M 芯片上虽然能启动,但耗电和发热完全是两回事。
1.3 安装包从哪拿:只走官方渠道
这一步没有讨论余地。JetBrains 官网的下载页直接可以拿到 IntelliJ IDEA 的安装包,社区版(Community)免费,旗舰版(Ultimate)是订阅制。下载页面上会同时列出 Windows、macOS(区分 Intel 和 Apple Silicon)、Linux 三个平台的包,Linux 下还有 tar.gz 和 snap 两种形式。
关于授权,正经路径有这几条:社区版完全免费,做纯 Java/Kotlin/Android(配合 Android Studio 的后端)开发够用,只是没有 Spring、数据库工具、HTTP Client 这些企业级功能;Ultimate 是订阅制,新用户一般有试用期;学生和教师可以申请免费的教育授权,用学校邮箱验证即可;开源项目维护者也能申请免费授权。这些渠道都能在官网找到入口,流程也不复杂。
我必须把话说重一点:网上那些所谓的"优化版""绿色版",绝大多数是重新打包过的,里面塞了什么你根本不知道。IDEA 会读取你的 SSH 密钥、Git 凭证、数据库连接串,甚至能把你的代码发到外部服务做索引分析,风险等级和装一个来路不明的输入法完全不是一个量级。省下的那点订阅费,换一次凭证泄露,得不偿失。
2. 下载与安装:把每一步的意图讲透
安装过程本身不难,难的是每一步它问你的那个问题,你到底该不该勾。这一章我会把 Windows、macOS、Linux 三条线都走一遍,并且把每个选项背后的取舍讲清楚,这样你以后换机器或者帮同事装的时候,不用再凭感觉点。
2.1 官网下载页面的几个选项怎么选
进到下载页,你会看到两列:左边是 Ultimate,右边是 Community。下面还有一排平台图标和"Other versions"的入口。这里有几个坑要说清楚。
第一,默认给你的是当前最新版,如果你明确要 2023 系列,得点开历史版本列表去找。第二,Windows 下载页面默认给的是 .exe 安装包,但也有免安装的 zip 包,区别后面讲。第三,macOS 上 Intel 和 Apple Silicon 是分开的两个 dmg,选错了虽然能跑,但性能损失很明显。
我个人的习惯是:主力开发机用 .exe / dmg 正规安装,测试机或者需要多版本共存的场景用免安装版。免安装版的好处是所有东西都在一个目录里,删掉就是卸载干净,不留残留,特别适合用来验证"到底是环境问题还是版本问题"。
2.2 Windows 安装向导逐步拆解
拿到 exe 双击,第一步是欢迎页,直接下一步。第二步是安装路径,这里我强烈建议改掉默认路径。默认会装到C:\Program Files\JetBrains\...,本身没问题,但如果你 C 盘空间紧张,就该换到别的盘。路径里不要有中文和空格,虽然现在支持得比以前好,但偶尔还是会在插件或者构建脚本上出问题,我图省事一直用的是纯英文短路径,比如D:\Dev\IDEA2023。
接下来是安装选项页,四个复选框,我一个个说:
- Create Desktop Shortcut:创建桌面快捷方式,看个人习惯,我一般勾上。
- Update PATH variable:把 IDEA 的命令行启动器加到 PATH 里,建议勾,勾了之后可以在终端里直接用
idea .打开当前目录,配合 Git 命令行工作流特别顺。 - Update Context Menu:在右键菜单里加"Open Folder as Project",这个是我最推荐勾的一项,看到某个项目文件夹直接右键就能打开,省掉"先启动 IDE 再 Open"两步。
- Create Associations:关联 .java、.kt、.groovy 等文件类型,看你机器上有没有别的 IDE。如果你同时用 Eclipse 或者 VS Code 做 Java,勾了会导致双击 .java 文件默认打开 IDEA,可能不是你想要的。
选完路径和选项就开始复制文件,大概一两分钟。安装完成后第一次启动会问你要不要导入之前的设置,如果你机器上装过老版本 IDEA,它会把老版本的配置目录列出来。这里要谨慎:跨大版本导入配置有时会把老版本的插件配置一起带过来,导致新版本启动报错,我的做法是第一次先选"不导入",等 IDE 跑起来确认没问题了,再去按需手动配。
2.3 macOS 与 Linux 的差异化处理
macOS 上拿到 dmg 挂载之后,把图标拖进 Applications 就完事了。第一次打开如果系统提示应用来自互联网,在"系统设置 - 隐私与安全性"里允许一次即可。要注意的是 Apple Silicon 用户,如果你不小心下了 Intel 版本,可以用"活动监视器"里的"架构"列确认一下,标着 Intel 的就是装错了,删掉重下 ARM 版本。
Linux 下我用得最多的是 tar.gz 解压版,因为服务器上跑不了图形界面安装器。整套流程大概是:下载 tar.gz,解压到一个固定目录(我习惯放/opt),然后直接执行bin/idea.sh。为了让所有用户都能用,可以创建一个 desktop entry 放到/usr/share/applications/,这样在应用菜单里就能搜到。命令长这样:
sudo tar -xzf ideaIU-2023.3.tar.gz -C /opt # 解压后目录名类似 idea-IU-233.11799.241 /opt/idea-IU-233.11799.241/bin/idea.sh如果你需要同时维护多个版本,强烈推荐用官方的 Toolbox App。它能同时管理好几个 IDE 和好几个版本,升级降级都是一键,还能自动更新。我们团队有个项目卡在某个老版本上,就是靠 Toolbox 在本地同时装了两个版本切换用,比手动装两遍干净太多。
2.4 静默安装与企业批量部署
如果你是给团队统一配环境,一台台点安装向导显然不现实。Windows 的 exe 安装包支持静默参数,一个配置文件加一条命令就能搞定:
ideaIU-2023.3.exe /S /CONFIG=silent.config /D=D:\Dev\IDEA2023几个关键点:/S表示静默安装,/CONFIG指向配置文件(里面可以指定是否创建快捷方式、是否加 PATH 等),/D必须是最后一项,而且路径不能带引号,中间也不能有空格。这一条踩过坑的人特别多,路径带空格会导致参数解析失败,安装程序直接退出且不报错,你会以为装完了结果找不到东西。
配置文件的内容大概是这样,按需增删:
mode=silent launcher32=0 launcher64=1 updatePATH=1 updateContextMenu=1 jre32=0 .java=1launcher64=1表示创建 64 位启动器,.java=1表示关联 Java 文件。企业环境里通常还会在安装后统一下发一份idea.properties和 vmoptions 文件,把内存参数、插件仓库地址、更新策略这些固定下来,避免每人一套配置导致问题难以复现。这个思路很值得借鉴,哪怕只有你一个人用,把配置集中管理起来,换机器时也能快速恢复。
3. 首次启动后的配置:把默认状态改成顺手状态
装完第一次打开,IDEA 会问你主题、插件、授权这几件事。很多人一路下一步点过去,用了一个月才发现在默认配置下写代码有多别扭。这一章讲的是我实测下来收益最高的几项配置,按优先级排。
3.1 授权方式的正经选项
启动向导里的授权环节,正经路子就三条:登录 JetBrains 账号激活订阅、填入公司或学校购买的授权服务器地址、选择免费试用或社区版。当选了"免费试用"之后,界面会提示剩余天数,到期后 IDE 会限制功能。
这里要特别说明一点:IDEA 会定期联网校验授权状态。如果你所在的环境网络受限,导致校验失败,IDE 可能会弹出提示甚至限制使用。正规做法是联系你公司的 IT 或者 JetBrains 的支持渠道,看是否有内部授权服务器可用。自己动手去"绕过"这类校验,既违反许可协议,也容易把 IDE 搞成半残状态——我见过有人改完之后 IDE 能开但插件市场永久打不开,最后只能全盘重装。遇到授权问题,走官方渠道,这是唯一能长期省心的路。
另外提醒一下,社区版和旗舰版的功能差异在启动后就能感受到:社区版没有 Spring 支持、没有数据库工具窗口、没有 HTTP Client、没有 JavaScript/TypeScript 支持(那是 WebStorm 的地盘)。如果你只是写纯 Java 后端小工具,社区版完全够;做 Spring Boot 项目,那几个工具窗口能省掉你装一堆外挂工具的功夫,值得考虑。
3.2 内存参数怎么算,改哪个文件
这一步是提升体验最明显的操作。IDEA 默认的最大堆一般是 2048MB,对现在的项目规模来说偏保守。改的位置有两个:图形界面在Help > Change Memory Settings,直接填数字重启即可;也可以直接编辑 vmoptions 文件,路径在安装目录的bin下(比如idea64.exe.vmoptions),或者在用户配置目录下建一份自己的覆盖文件。
参数怎么给?我的经验公式是:最大堆不超过物理内存的一半,同时给系统和其他进程留足空间。
| 物理内存 | Xmx 建议值 | 说明 |
|---|---|---|
| 8G | 2048 | 再往上给会让系统开始换页,反而更卡 |
| 16G | 4096 | 大多数项目的甜点区 |
| 32G | 8192 | 超大单体项目、多开微服务时才需要 |
| 64G | 12288 ~ 16384 | 一般用不到,除非同时跑多个 IDE 实例 |
除了-Xmx,还有几个参数值得加:-XX:ReservedCodeCacheSize=512m给 JIT 编译代码留缓存,-XX:+UseG1GC显式指定 G1 回收器(新版本默认就是),-XX:SoftRefLRUPolicyMSPerMB=50这个参数对索引缓存命中率有帮助。不要盲目堆参数,我试过把 Xmx 拉到物理内存的 70%,结果系统频繁 swap,索引速度反而慢了一倍。
注意:如果你用的是 Toolbox 管理的版本,修改内存设置会写到用户目录下的 vmoptions 文件,升级 IDE 时不会被覆盖。手动改安装目录里的文件则在每次大版本升级后需要重新设置。
3.3 编码、字体、自动导入这几项按这个设
先说编码,这是出问题最多的地方。进Settings > Editor > File Encodings:
- Global Encoding 和 Project Encoding 全部设成 UTF-8
- Default encoding for properties files 也设成 UTF-8
- 勾上 Transparent native-to-ascii conversion
最后这一项很多人不知道。Java 的.properties文件历史上只支持 ISO-8859-1 编码,中文必须写成\uXXXX转义。勾上这个选项之后,IDEA 在文件层面用 UTF-8 存中文,读写时自动转换,你看到的是正常中文,实际文件里也是可读的。不勾的结果是:你在 IDE 里看到乱码,或者编译后中文变成问号。这个坑几乎每个做国际化配置的人都会踩一次。
再说字体。Settings > Editor > Font,我推荐用JetBrains Mono(IDE 自带),字号 15~16,行高 1.2。这个字体对0/O、1/l/I这类易混字符做了区分,长时间看代码眼睛会舒服很多。开启连字(Ligatures)之后,!=、->、>=这些符号会合并显示,有人爱有人恨,建议先开着用一周再决定。
最后是自动导入,Settings > Editor > General > Auto Import,把Add unambiguous imports on the fly和Optimize imports on the fly都勾上。前者的作用是:你敲List回车,它自动补import java.util.List——但注意是"无歧义"时才补,如果List同时存在于多个包,它不会瞎猜。后者是删掉不再使用的 import,保持文件干净。这两个开了之后,手动敲 import 的场景能减少九成。
还有一个提高效率的小设置:Settings > Editor > Code Style > Java > Imports,把Class count to use import with '*'和Names count to use static import with '*'都改成 999。默认值是 5,意味着一个包下导入超过 5 个类,IDEA 会自动合并成import java.util.*。这在个人项目里无所谓,但在团队协作里会引发无意义的 diff,很多公司的代码规范明确禁止星号导入。
3.4 JDK、Maven、Gradle 的项目级配置
IDE 自带的运行时(JBR)和你的项目 JDK 是两码事。前者是 IDEA 自己跑起来用的 JVM,不用你操心;后者是编译和运行你代码用的 JDK,必须自己配。
配置入口在File > Project Structure > Project:SDK 选你装好的 JDK,Language level 选对应版本。JDK 建议单独安装在统一目录,比如D:\Dev\JDK\jdk-17,别用安装器默认那个带空格的路径,也别用 IDEA 自带的 JBR 当项目 JDK——JBR 是改过的,某些依赖反射的工具会出问题。
Maven 的配置是另一个高频问题。Settings > Build, Execution, Deployment > Build Tools > Maven,三件事要做:
- Maven home path指向你自己装的 Maven(比如 3.8.x 或 3.9.x),不要用 IDE 捆绑的那个老版本。
- User settings file指向你的
settings.xml,并且勾上 Override。 - Local repository确认一下路径,别跟别人的配置混在一起。
settings.xml里最值得加的就是仓库镜像,把中央仓库换成国内加速地址,依赖下载速度差别非常大。典型配置长这样:
<mirrors> <mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>aliyun public</name> <url>https://maven.aliyun.com/repository/public</url> </mirror> </mirrors>Gradle 项目的话,Settings > Build Tools > Gradle里把Distribution 选成自己装的那份,并且Gradle JVM指定成项目用的 JDK。默认它每次都用 Wrapper 下载,第一次导入能等十几分钟,换成系统安装的就快很多。
提示:如果导入 Maven 项目后依赖全是红的,先别急着删缓存。按顺序检查:Settings 里的 Maven 路径对不对、settings.xml 有没有被正确识别、本地仓库里那个 jar 是不是只有个
.lastUpdated文件(说明下载失败过)。最后这招最有效——把.lastUpdated文件删掉再重新导入。
3.5 插件装哪些,哪些该关掉
插件是提升效率的利器,也是拖慢 IDE 的元凶。我的原则是:先关掉不用的,再按需装。Settings > Plugins > Installed里可以把用不到的全禁用掉,比如如果你不做 Android、不做 Kotlin、不用 JS,相关的插件都可以关,启动时间和内存占用会明显下降。Usage Statistics这类统计上报的插件我也习惯关掉。
值得装的插件,我挑几个实用且口碑比较好的:
- MyBatisX / MyBatis Log Free:写 MyBatis 的必备,XML 里的 SQL 和方法之间能直接跳转,日志也能还原成可执行的 SQL。
- Maven Helper:看依赖树、排查依赖冲突,比敲命令行直观得多。
- SonarLint:本地就能跑静态检查,很多低级问题在提交前就能拦住。
- Translation:看开源项目时选中英文直接翻译,比切浏览器快。
- Rainbow Brackets:多层嵌套的括号用不同颜色区分,复杂表达式里能明显减少看错括号的情况。
- Alibaba Java Coding Guidelines:如果团队用阿里规范,这个检查能省掉不少 review 意见。
插件装完要重启 IDE。注意插件的兼容性提示:装的时候它一般会告诉你"这个插件在 2023.3 上未经验证",这类情况可以先装,如果重启后启动变慢或者报错,Help > Show Log in Explorer打开日志看具体异常,多半是插件问题,禁用掉即可。
4. 踩坑实录:安装与启动阶段的典型故障排查
这一章是我这些年处理过的真实问题汇总,按发生频率排序。每个问题我会先讲现象,再讲排查思路,最后给解决办法。遇到问题别慌,八成的故障都能在五分钟内定位。
4.1 双击没反应、闪退、或者卡在加载界面
现象:双击图标,鼠标转两圈就没了;或者启动画面进度条走一半停住。
先做一件事:用命令行启动,看有没有报错输出。Windows 下进到bin目录执行idea.bat,macOS 和 Linux 下执行bin/idea.sh。命令行会把 JVM 的报错直接打在控制台上,比看日志快得多。
常见的几个原因:
一是配置目录损坏。这是最常见的。IDEA 的配置存在用户目录下,路径大概是 Windows 的C:\Users\<你的用户名>\AppData\Roaming\JetBrains\IntelliJIdea2023.x,macOS 的~/Library/Application Support/JetBrains/IntelliJIdea2023.x,Linux 的~/.config/JetBrains/IntelliJIdea2023.x。处理办法是把整个目录重命名备份(别直接删),再启动一次,IDE 会重新生成一份干净的配置。如果这次能起来,说明就是配置坏了,再逐步把老配置里的关键文件拷回来。
二是 vmoptions 文件写错了。手工改内存参数时多打一个空格、参数名拼错,都会导致 JVM 拒绝启动。直接把这个文件删掉,IDE 会用默认值重新生成一份。
三是显卡驱动问题。新 UI 大量使用 GPU 渲染,老显卡驱动上会直接黑屏或者起不来。可以在启动参数里加-Dsun.java2d.d3d=false或者禁用新 UI 试试。macOS 上如果外接显示器出了问题,拔掉再启动也是个排查手段。
四是安装目录路径带中文或者特殊字符。这个我提过,但还是要再说一遍,因为真的有人栽在这上面。
4.2 卡顿、索引慢、风扇狂转
现象:右下角一直显示 "Indexing",进度条走得极慢;或者打字有几百毫秒延迟,风扇一直响。
先分清是索引慢还是内存不够。打开Help > Diagnostic Tools > Show Memory Indicator,右下角会显示当前堆使用量。如果长期贴着上限(比如 2048M 里用到 1900M 以上),那就是内存不足,按前面 3.2 的表格往上调。
索引慢的话,有几个针对性做法:
第一,把不需要索引的目录排除掉。右键项目里的node_modules、dist、target、日志目录,选Mark Directory as > Excluded。这些目录里的文件对你的代码没有语义贡献,但会被全量扫描,一个大node_modules就能让索引时间翻倍。
第二,确认项目在 SSD 上。这不是玄学,机械硬盘上导入一个大项目,索引能耗你半小时,SSD 上就三五分钟。
第三,排除杀毒软件的实时扫描。把项目目录和 IDEA 的缓存目录加进杀毒软件的白名单,实时扫描会拦截大量文件读写操作,索引期间的开销非常可观。
第四,关掉 Power Save Mode。这个模式在File菜单里,开启后会关闭所有代码检查和后台分析。有人为了"省资源"开了它,结果发现代码提示全没了,还以为 IDE 坏了。
4.3 中文乱码与快捷键冲突
乱码分几种情况,得区别对待。
代码文件里的中文乱码:回到Settings > Editor > File Encodings,检查三个编码是不是都设成了 UTF-8,以及Transparent native-to-ascii conversion有没有勾。另外看一眼右下角状态栏显示的编码,如果单个文件是 GBK,可以点那里改成 UTF-8 再转换。
控制台输出的中文乱码:这是另一回事。Logback 或者 Tomcat 的控制台输出乱码,通常需要在运行配置的 VM options 里加上-Dfile.encoding=UTF-8。同时检查Settings > Editor > General > Console里的默认编码,以及在项目启动脚本里设置JAVA_TOOL_OPTIONS。
Git 提交记录里的中文乱码:在git config里设置i18n.commitEncoding=utf-8和i18n.logOutputEncoding=utf-8。
快捷键冲突也很烦人。最典型的是Ctrl+Shift+F(全局搜索),被中文输入法的简繁切换占用,按下去弹出来的是"简体/繁体"切换菜单。解决办法是在输入法设置里把这个快捷键关掉,或者把 IDEA 的全局搜索改成Ctrl+Shift+R之类。国内常见的截图工具、聊天软件也爱抢快捷键,遇到按了没反应的情况,先在输入法和其他常驻软件里排查一遍。
4.4 依赖下载慢、插件市场进不去
依赖下载慢,前面已经说了镜像的配置。但还有一种情况:镜像配了还是慢,那通常是项目里引用了镜像仓库里没有的私有依赖,或者settings.xml里有多个 mirror 互相覆盖。用mvn -X看详细的下载日志,能定位到具体卡在哪个地址。
插件市场加载不出来,现象是Settings > Plugins > Marketplace一直转圈。这种情况下的通用处理是:先确认网络能访问外部站点,然后在Settings > Appearance & Behavior > System Settings > HTTP Proxy里选 "No proxy" 或者 "Auto-detect",改完重启试试。如果确实无法从市场安装,还有离线方案:在 JetBrains 的插件市场网页上按版本号下载插件 zip 包,然后在Settings > Plugins右上角齿轮菜单里选Install Plugin from Disk,选那个 zip 文件即可。这个办法在网络受限的环境里非常实用。
4.5 重装与配置迁移怎么不丢东西
想彻底重装一遍,或者换台新机器,需要迁移哪些东西?我把关键目录列一下。
| 内容 | 位置(Windows) | 是否需要迁移 |
|---|---|---|
| 用户配置(设置、快捷键、插件列表) | %APPDATA%\JetBrains\IntelliJIdea2023.x | 需要,重点迁移options目录 |
| 缓存与索引 | %LOCALAPPDATA%\JetBrains\IntelliJIdea2023.x | 不需要,删掉能解决很多疑难杂症 |
| 安装目录 | D:\Dev\IDEA2023 | 不需要 |
| 项目配置 | 项目目录下的.idea | 看情况,团队项目通常提交到 Git |
完整的迁移流程我一般这么做:先在旧机器上用File > Manage IDE Settings > Export Settings导出一个 zip;新机器上装好 IDE,首次启动时选择导入这个 zip。这比手动拷目录干净得多。但要注意:导出包里不含插件本体,只含插件列表,新机器上还得让它自己去下载一遍。
想清干净地卸载,Windows 上用安装目录里的卸载程序,然后手动删掉上面表格里的配置和缓存两个目录,否则重装后问题依旧。macOS 上如果用 Toolbox 装的,直接在 Toolbox 里卸载,它会问你要不要一并清理配置,选择清理即可。用 tar.gz 装的 Linux 版,直接删目录就行,但记得把~/.config和~/.cache下的对应目录也删掉。
注意:删配置目录之前先确认项目里没有只存在 IDE 里的配置。比如你手动配置的数据库连接、运行配置、HTTP 请求文件,这些如果没跟着项目走,删了就得重配。我现在的做法是把运行配置导出成
.run文件提交到项目里,换机器直接能用。
5. 装完之后值得花半小时做的几件事
环境装好、能跑起来,其实只算完成了一半。下面这几件事花不了多少时间,但对日常写代码的顺滑度影响很大,我每次配新环境都会做。
第一件事,把常用快捷键真正用起来。IDEA 的默认键位已经设计得很合理,别急着换成 Eclipse 键位。我建议先强制自己用这几个:Ctrl+Shift+A(搜索任何操作,忘了快捷键就按它)、Alt+Enter(万能提示,用来补 import、改签名、修错误)、Ctrl+Alt+L(格式化代码)、Ctrl+Shift+Enter(补全当前语句,自动加分号和大括号)、Shift+Shift(随处搜索,文件、类、方法、设置全都能搜)。这五个键覆盖了日常最高频的操作,一周就能形成肌肉记忆。
第二件事,配好 Live Template。Settings > Editor > Live Templates,可以把你重复写的代码片段做成模板。比如日志打印、单元测试骨架、if (obj == null)判断这类,配一次省无数次。我自己的soutv打印变量、fori循环这些系统自带模板基本够用,只额外加了两三个团队约定格式的模板。
第三件事,用上本地历史。IDEA 的Local History(右键文件或目录选Local History > Show History)会记录你每次修改的时间点,即使没有 Git 也能回滚。这个功能救过我无数次——手滑删了一段代码还没提交,靠它找回来了。它默认开启,但要知道它在哪、怎么用。
第四件事,把 Git 集成打通。Settings > Version Control > Git里确认 Git 可执行文件路径正确,然后在项目根目录执行git init之后,IDEA 会自动识别。之后在 IDEA 里提交、切分支、看 diff 都很顺。建议把.idea目录里的一些本机相关文件写进.gitignore,比如workspace.xml、shelf目录,避免团队协作时互相覆盖配置。
第五件事,设置好代码风格并导出。Settings > Editor > Code Style,把缩进、换行、空格这些按团队规范设好,然后导出成 XML 提交到项目里。这事看着小,但能省掉大量格式化的无意义争论。我们团队之前每次 review 都在吵大括号位置,后来统一了 Code Style 文件,这类评论直接归零。
最后再补一个我自己踩过的坑:别在项目打开的状态下直接升级 IDE。我试过一次,升级到一半 IDE 自动重启,索引重建到一半被打断,结果缓存目录直接坏了,最后只能把缓存目录全删重来。正确的做法是关掉所有项目,退出 IDE,再执行升级,升级完第一次启动让它安安静静把索引跑完再动手。这个细节没人会提醒你,但真出事的时候会浪费你半天时间。