很多刚接触Java的朋友，开口问我的第一句话往往不是“Java怎么学”，而是“用什么写Java”。我在Java这个行当里泡了十来年，IDE从Eclipse换到NetBeans再换到IntelliJ IDEA，最后彻底稳定在IDEA上没再挪过窝。身边新来的同事、带过的实习生、甚至一些转行的朋友，几乎人手一个IDEA，因为它在代码补全、重构、调试和Spring全家桶支持上都做得太顺手了。今天这篇完全指南，就是针对那些还没装过IDEA、或者装完不知道接下来该干什么的人，一次性把环境准备、版本选择、安装步骤、创建Java项目、常见配置和踩坑实录全部讲透，拿走就能照着做。
1. 为什么选择IntelliJ IDEA：编辑器口碑与版本定位
1.1 一个写Java的人，绕不开的工具
先说一个最基本的事实：Java是一个编译型语言，源代码写在哪都行，记事本也能写，但记事本没法给你检查语法、跳转定义、自动补全、批量重构。IDE（集成开发环境）就是把这些活儿全都揽下来的工具。IntelliJ IDEA在Java IDE里属于公认的第一梯队，尤其对Spring Boot、Maven、Gradle这类Java生态的主流框架，开箱即用程度很高。我自己最直观的感受是，IDEA的代码索引速度很快，几十万行的老项目打开以后，跳转和搜索基本没有明显卡顿；而它的“意图操作”（Alt+Enter）也常被我拿来快速补全实现方法、处理异常、生成测试，节省的时间非常可观。
很多人在网上争论IDEA和Eclipse孰优孰劣，其实这个问题在今天已经不那么尖锐了。Eclipse的历史包袱更重，老项目里用得很多，但新项目、新团队默认选IDEA的比例逐年上升。对一个新手来说，选IDEA的另一个现实原因是：你搜“Java开发环境搭建”，十篇教程里起码有八篇用IDEA演示，跟着参考资料走会顺很多。这篇指南后面的所有操作，也都是以IDEA为基准讲的。
1.2 社区版与旗舰版到底怎么选
JetBrains官网把IntelliJ IDEA分成两个版本：社区版（Community版）和旗舰版（Ultimate版）。社区版是免费且开源的，许可证允许商业使用，功能上覆盖了Java、Kotlin、Groovy、Scala这些JVM语言的基础开发，也支持Maven、Gradle、Git、JUnit这些日常必备的工具。旗舰版是付费订阅的，额外提供Spring、Spring Boot、Jakarta EE框架的专门支持，以及数据库工具、HTTP客户端、远程开发、Docker和Kubernetes集成等功能。
很多新手会纠结要不要直接上旗舰版。我的建议是：如果你现阶段就是写Java基础语法、做课程设计、刷LeetCode、跟一些SSM或Spring Boot入门项目，社区版完全够用。社区版照样能创建Maven工程、写代码、跑测试、调试，只不过Spring Boot项目不会给你提供“创建立即自动识别Bean”那种框架级智能提示，但语法高亮、代码补全、跳转这些核心能力都在。等到你真正需要开发企业级项目、要连数据库频繁查表结构、要跑多模块微服务的时候，再考虑旗舰版也不迟。
这里必须多说一句：网上搜IDEA很容易看到各种“激活码”“永久许可”相关的内容，这些都不要碰。社区版本来就是免费的，直接下载就能合法使用；如果你想用旗舰版的完整功能，JetBrains为在校学生和教师提供免费的教育许可，用学校邮箱就能申请，只要是正规学习用途，免费渠道完全能覆盖你的需求。我见过太多人为了省一点订阅费去用来路不明的破解补丁，结果电脑被植入挖矿程序、数据被窃取，得不偿失。工具而已，别拿环境安全开玩笑。
2. 安装前要搞清楚的准备工作
2.1 JDK安装与环境变量配置：IDEA自己的电脑有Java才行
IDEA本身是用Java写的，但它运行不依赖你机器上的JDK，JDK是给“你要编译运行Java程序”用的。也就是说，装完IDEA之后，如果不装JDK，照样可以打开软件，但没法编译运行任何Java代码。这两者的关系就像翻译器和外语词典：IDEA是帮你写代码的编辑器，而JDK（Java Development Kit）才是真正把源代码编译成字节码、然后交给JVM运行的引擎。
JDK的获取很简单，去Oracle官网下载OpenJDK或者Oracle JDK都行，也可以选Adoptium、Amazon Corretto等发行版。我的个人习惯是优先用Adoptium的OpenJDK，因为它没有Oracle JDK那些商业授权限制，更新也比较稳定。版本方面，现在Java 17是长期支持版本（LTS），Java 21也已经稳定，日常学习和绝大多数工作项目用17就够，不要盲目追新。版本选太新，有时候会遇到框架兼容问题，反而麻烦。
安装JDK之后，需要配置环境变量。Windows下的路径是：右键“此电脑”→属性→高级系统设置→环境变量。在“系统变量”里新建JAVA_HOME，值填你的JDK安装目录，比如C:\Program Files\Eclipse Adoptium\jdk-17.0.10，然后编辑Path变量，新增一条%JAVA_HOME%\bin。配置完以后打开命令行，输入java -version，如果能正确输出版本号，说明环境变量配置成功。macOS和Linux一般不用手动配，用Homebrew或包管理器装的JDK大多会自动注册好路径，不过为了保险，装完同样敲一下java -version确认。
2.2 IDEV硬下载渠道与版本对应
IDEA的官方下载地址是JetBrains官网，不要从第三方软件站下载安装包，那些站点捆垃圾软件是家常便饭。官网首页直接找“Developer Tools”里的IntelliJ IDEA，进去以后就是两个版本的大按钮：Download Community和Download Ultimate。页面上还会根据你当前访问的操作系统自动推荐Windows、macOS或Linux版本，也可以手动切换。
这里有个细节：下载页面里Windows版会分exe安装包和zip压缩包两种格式。exe是图形化安装向导，适合大多数人；zip免安装版适合那种不想写注册表、想绿色携带的场景，解压就能用，但每次启动需要手动运行bin目录下的idea64.exe。我建议新手用exe安装包，省事，卸载也干净。
版本号方面，JetBrains一年发布三个大版本左右，比如本指南写到的2026.1、2026.2都是比较新的版本。其实版本号不必追新，稳定使用一个版本半年以上都很常见。唯一要留意的是：新版本第一次打开老项目时，会提示你迁移索引，一般默认确认就行；如果项目里用了某些老框架，新版本偶尔会有不兼容的警告，这时候可以等框架适配后再升级，不用着急。
2.3 系统配置要求与启动内存
IDEA是出了名的内存大户，这是很多新手第一次打开后最直观的吐槽点。官方推荐配置是8GB内存起步，但要开一个中等规模的Spring Boot项目，8GB其实也不算宽裕。我实际使用下来的感觉是：16GB内存跑IDEA加浏览器、加数据库客户端，比较舒服；如果只有8GB内存，尽量别同时开太多大型软件，IDEA自己的-Xmx参数也可以调低一点。
IDEA的启动参数在安装目录的bin\idea64.exe.vmoptions文件里（macOS对应idea.vmoptions）。里面默认的-Xmx通常是2GB左右，如果你的机器内存大，比如32GB，可以把它改成-Xmx4096m甚至更高，索引大型项目时会明显更流畅。反之只有8GB内存的话，建议保持默认，强行调高大内存反而会把整个系统拖垮，经常卡顿到底。这个文件改完需要重启IDEA才能生效。
换句话说，装IDEA之前最好先看一眼自己电脑的磁盘空间，IDEA安装包大约600MB，解压安装后占用1GB出头，再加上JDK、Maven仓库和其他开发工具，C盘最好留出5GB以上的空余。如果C盘紧张，安装时把目录改到D盘，或之后把Maven本地仓库挪到别的盘，都是很常见的操作。
3. 完整安装流程：Windows和macOS不走冤枉路
3.1 Windows安装步骤详解
Windows安装IDEA的过程本身并不复杂，但有几个容易被忽略的选项。我以最新版exe向导为例，一步一步拆开讲。
双击下载好的安装包，首先欢迎页直接点Next。然后选安装目录，默认是C:\Program Files\JetBrains\IntelliJ IDEA Community Edition 2026.2这种路径，这个可以改成D盘，但注意路径最好不要有中文或特殊字符，避免后期编译和脚本可能出现乱编码问题。接下来有一个“Installation Options”页面，这里新手容易踩坑。
这一页有四个复选框：创建桌面快捷方式、更新PATH环境变量、更新共享菜单（右键打开方式）、关联.java文件。我的建议是：桌面快捷方式按喜好选，PATH环境变量建议勾上，这样以后在命令行里可以直接敲idea命令打开项目，很方便；关联.java文件这一项可以勾，也可以不勾，勾了之后在资源管理器里双击.java文件就会用IDEA打开，但很多人会觉得这有点烦，因为有时候想用记事本快速看文件突然也被IDEA接管了。共享菜单对我来说用处不大，一般去掉。
然后点Install，等进度条走完。最后一步会问你是否现在启动IDEA，默认勾选的Launch IntelliJ IDEA可以保持，Installation目录下还会生成一个idea64.exe的启动文件，如果桌面没有快捷方式，也可以从安装目录的bin文件夹里启动。整个过程大概两分钟，装完以后直接进首次启动配置界面。
3.2 macOS安装步骤详解
macOS上装IDEA有两种方式：一是从官网下载.dmg镜像，双击打开以后把IntelliJ IDEA图标拖进Applications文件夹，完成；二是如果你装了Homebrew，brew install --cask intellij-idea（社区版是intellij-idea-ce）一条命令也能搞定。Homebrew方式的缺点是下载源在国外，网络不稳时可能很慢，官方镜像拖拽方式反倒更可控。
第一次启动的时候，macOS会提示“无法打开，因为来自身份不明的开发者”之类的话。这种情况通常是因为没有从App Store下载的软件都会触发Gatekeeper校验，解决办法是打开“系统设置→隐私与安全性”，在底部找到“仍要打开”按钮，点一下确认就行。如果是通过Homebrew安装的，一般不会有这个提示，因为Homebrew会用合法的开发者签名处理掉。
macOS版IDEA同样存在内存问题。默认的idea.vmoptions也在Contents/bin目录下，想调整的话，右键IntelliJ IDEA应用程序，选“显示包内容”，进去以后就能找到。用文本编辑器改-Xmx参数即可。别的方面，Windows和macOS的界面布局、配置流程基本一致，下面说的项目创建和配置内容都能通用。
3.3 首次启动配置与界面认识
第一次启动IDEA，会看到一个导入设置的界面。如果你之前用过老版本IDEA，这里可以选C:\Users\你的用户名\AppData\Roaming\JetBrains下的旧配置目录，把之前的配色、快捷键、插件都迁移过来。如果是全新安装，默认选Do not import settings就行。
接下来需要选择UI主题。IDEA有Light（亮色）、Dark（暗色）、High Contrast等选项，新版本还支持自定义背景图。大多数人直接选Darcula深色主题，写代码时眼睛相对舒服一些。然后是是否启用“默认代码示例、工具窗口、插件市场”等数据共享，想保持隐私就全都不勾，不影响核心功能。
进入主界面以后，它的布局分为几个区域：左边是项目浏览窗口（Project），中间是代码编辑器，底部是终端、构建输出、版本控制等工具窗口，右边是Maven/Gradle等面板。首次打开默认会显示一个Welcome页面，有New Project、Open、Get from VCS等按钮。此时你完全可以先点New Project创建项目，也可以先装插件、改设置，看个人习惯。
4. 创建第一个Java项目：从New Project到Hello World
4.1 图形化创建步骤的每一步细节
IDEA的New Project向导，不同版本之间略有差别，但逻辑是一致的。我以社区版2026.x为例说明。
在Welcome页面点New Project，左侧导航会出现“New Project”“Empty Project”“Generators”等选项。选New Project，然后右侧会有一个语言选择的下拉框，默认是Java，保持即可。下方的Build System通常有三个选项：IntelliJ、Maven、Gradle。这里我建议新手直接选Maven，因为后面你大概率要建Maven工程，提前熟悉这个结构没坏处。
Build System选完之后，有一个“JDK”下拉框，如果之前配好了JDK并设置了JAVA_HOME，这里会自动识别你机器上的JDK版本。如果列表是空的，点旁边的Add JDK手动选择安装目录，Windows选到jdk-1.8或jdk-17那个文件夹即可。类路径里的“Sample”可以勾上，创建一个带示例代码的模板，不过对于Hello World级别来说创建空项目就够了。
再往下是“Project name”和“Project location”。项目名建议用英文，不要用中文，虽然IDEA支持中文路径，但有些构建工具和脚本对中文路径兼容得不好，容易出各种莫名其妙的编码问题。项目位置默认在用户目录下的IdeaProjects文件夹，也可以自己指定，比如D:\Code\demo-hello。最后点Create，IDEA会花几秒钟初始化项目结构。
4.2 认识Maven项目结构和运行按钮
创建完成以后，你会看到一个完整的Maven项目结构。src/main/java是源代码目录，src/main/resources放配置文件，src/test/java放单元测试，根目录下的pom.xml是Maven的配置文件，里面声明了项目坐标、依赖、插件、Java版本等信息。
最开始接触这个结构，不用管太多，只需要知道：你的Java源文件放在src/main/java下面，包名一般用反域名格式，比如com.example.demo。创建类很简单，右键src/main/java，选择New → Java Class，输入类名，勾选public static void main(String[] args)那一项，IDEA会自动生成main方法模板。
写一个HelloWorld，代码就是最经典的：
public class HelloWorld { public static void main(String[] args) { System.out.println("Hello, IntelliJ IDEA!"); } }写完以后，编辑器左侧会有一个三角形运行按钮，点它就能直接编译并运行，底部的Run窗口会输出Hello, IntelliJ IDEA!。这一步能顺利跑通，就说明你的JDK、环境变量、IDEA三大件全部没问题了，整个环境搭建最难的坎已经越过。
4.3 创建一个真正的Java Web项目（Spring Boot示例）
建好HelloWorld之后，很多人下一个目标就是做Web项目。如果你的社区版想跟Spring Boot，我这里直接推荐两种做法：一种是去Spring Initializr官网（start.spring.io）在线生成项目压缩包，然后解压后用IDEA直接打开，这种方式对社区版非常友好，因为生成的Maven项目不依赖IDEA的框架支持；另一种是直接在IDEA里用Maven新建项目，然后手动在pom.xml里添加spring-boot-starter-web依赖。
用start.spring.io的方式，页面上选Maven、Java 17、Spring Boot版本，依赖里勾Spring Web，然后Generate下载。解开压缩包以后，IDEA的Welcome页面选Open，定位到解压目录，选择pom.xml文件打开。IDEA会识别Maven项目，自动下载依赖。首次下载Spring Boot相关的jar包通常要几分钟，这取决于网速和Maven仓库配置（后面我会讲国内镜像加速）。
用这种方式建出来的项目里，src/main/java/com/example/...下面有一个主类，类名一般是项目名+Application，比如DemoApplication。直接运行这个类的main方法，控制台打印出Tomcat started on port 8080（Spring Boot内嵌Tomcat）之后，浏览器访问http://localhost:8080就能看到Spring Boot默认的错误页面或接口返回。整个过程就说明你的环境已经能支撑完整的Web开发了。
5. 安装后必调的配置：从迈入到顺手
5.1 Maven配置：默认仓库改造与国内镜像
新建Maven项目以后，IDEA会在用户目录下的.m2\repository目录里缓存所有下载的依赖jar包。默认情况下Maven中央仓库在国外，国内拉依赖时经常超时失败，所以第一步就是配置镜像。
打开IDEA，进入File → Settings → Build, Execution, Deployment → Build Tools → Maven。这里的Maven home path默认指向IDEA自带的Maven，版本通常是Bundled（内置3.x），对我们日常使用没啥问题。重点是User settings file和Local repository这两项：Local repository默认是C:\Users\用户名\.m2\repository，可以改到一个非C盘路径，比如D:\maven-repo，这样重做系统或清理C盘时不会丢依赖缓存。
User settings file对应的是settings.xml文件，默认在C:\Users\用户名\.m2\settings.xml。这个文件需要自己创建，内容可以只写镜像配置：
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"> <mirrors> <mirror> <id>aliyun</id> <mirrorOf>central</mirrorOf> <url>https://maven.aliyun.com/repository/public</url> </mirror> </mirrors> </settings>改完以后，在IDEA的Maven面板里点刷新按钮，让设置重新加载。之后再创建项目、下载依赖，速度会有质的提升。我这里用阿里云镜像做例子，现在也有很多团队用华为云、腾讯云的镜像，效果都差不多，选一个稳定的就好。
5.2 界面与编辑体验：字体、编码、快捷键
IDEA有很多默认设置，不等于最佳设置。我讲几个每次装完新环境第一件事就要改的地方。
第一是字体和字号。File → Settings → Editor → Font，把字号从默认的13调大到16左右。写代码坐一天，字号太小特别伤眼睛。字体上，Windows推荐Consolas或JetBrains Mono，中文注释的显示则可以在Color Scheme → Font里把fallback字体改成微软雅黑，避免注释方块乱码。
第二是编码。Settings → Editor → File Encodings，把Global Encoding、Project Encoding、Default encoding for properties files全部设为UTF-8。这个不改好，项目里出现中文乱码是迟早的事，尤其是Windows环境，默认GBK编码容易让项目在不同人电脑之间流转时出现乱码。
第三是快捷键。IDEA默认的快捷键是自家JetBrains的，如果你之前用惯了Eclipse，可以在Settings → Keymap里把方案切到Eclipse。这个切换很重要，因为很多Eclipse老用户刚上手IDEA时，Ctrl+Shift+O变成按Alt+Enter，容易崩溃。用几天以后，我建议还是切回IntelliJ方案，因为很多教程里讲的快捷键以默认方案为准，切换方案会导致部分教程对不上号。
5.3 集成Tomcat：跑传统Java Web的完整配置
虽然Spring Boot自带内嵌Tomcat，但很多学校和企业老项目还是传统的外置Tomcat部署方式。IDEA社区版本身没有专门的Tomcat运行插件支持，但你可以用“本地外部工具”方式来启动Tomcat，而旗舰版则有内置的Application Servers集成。对于社区的常见需求，我推荐用Maven插件的方式，比配置外部Tomcat更省心。
如果你用的仍然是传统的Servlet项目，代码放在src/main/webapp下，基于Maven构建，可以在pom.xml里加入Tomcat Maven插件：
<plugin> <groupId>org.apache.tomcat.maven</groupId> <artifactId>tomcat7-maven-plugin</artifactId> <version>2.2</version> <configuration> <port>8080</port> <path>/</path> </configuration> </plugin>然后在IDEA右侧Maven面板中找到Plugins → tomcat7-maven-plugin → tomcat7:run，双击就能启动Tomcat，浏览器访问http://localhost:8080即可看到页面。这种方式的好处是不需要在IDEA里额外设置外部Tomcat路径，只需要你的机器本地装了Tomcat和解压目录即可（插件会用本地Tomcat运行）。
如果你一定要用IDEA的Tomcat Server方式来跑，流程是：Run → Edit Configurations → 左上角加号 → Tomcat Server → Local，在Application server里指向你本地的Tomcat安装目录，然后在Deployment标签页把项目加到Server里，设置Application context为/。端口默认8080，如果被占用可以改成8081、9090等。这个配置方式在旗舰版上更顺滑，社区版配置时会遇到部分选项不可用的情况，不用纠结，方法是死的，人是活的。
坦白讲，现在企业里用Spring Boot的人远比传统Servlet项目多，你自己学习时建议直接上Spring Boot，既能接触现代Java开发范式，又能省掉大量Tomcat配来配去的时间。
5.4 集成版本控制：Git与SVN
代码没有版本控制，等于裸奔。IDEA内置了Git和SVN支持，不需要额外装插件。第一次从远程仓库拉代码时，操作是：Welcome页面 → Get from VCS → 选择GitHub或Git，粘贴仓库地址，选好本地目录，Clone。IDEA会自动识别仓库里的Maven或Gradle项目结构，并弹出提示让你导入项目，这时用默认Import，等依赖加载完即可。
日常使用中，编辑器左侧的标注条会显示每行代码的修改状态，绿色表示新增，蓝色表示修改，灰色表示删除。改完代码后，在Commit工具窗口里可以看到Diff，写清楚提交信息后再提交。push就直接点工具栏的推送按钮，输入账号密码时，按钮会提示你使用Token而非密码（2021年以后GitHub取消了密码认证，只能通过Personal Access Token）——这是很多人第一次Git操作报401错误的经典原因。
SVN的集成也类似。File → Settings → Version Control → Subversion，指向SVN客户端路径。新版本IDEA提醒过多次SVN支持可能逐渐弱化，但老项目里SVN依然常见，尤其是那些集团企业内部沿用多年的代码仓库。如果你公司还在用SVN，就用IDEA自带的SVN支持就行，偶尔遇到无法连接时，记得检查你本地的SVN命令行客户端是否安装，某些IDEA版本依赖系统SVN环境。
6. 常见问题排查与踩坑实录
6.1 高频问题速查表：照着做就能解决
我把这些年帮同事排查IDEA问题的经验整理成了一张速查表，挑最典型的几条列在下面：
| 问题现象 | 根本原因 | 解决办法 |
|---|---|---|
输入java -version报“不是内部或外部命令” | JAVA_HOME和Path没配好 | 检查环境变量路径，确认%JAVA_HOME%\bin已加入Path，重新打开命令行 |
| Run窗口提示“错误: 找不到或无法加载主类 HelloWorld” | 项目编译器输出目录损坏或缓存异常 | File → Invalidate Caches and Restart，缓存重建后重新编译运行 |
| 警告“源发行版 17 需要目标发行版 17” | Maven编译器插件默认版本与项目JDK版本不一致 | 在pom.xml中设置<maven.compiler.source>17</maven.compiler.source>和<maven.compiler.target>17</maven.compiler.target> |
| 创建Spring Boot项目后，Maven依赖下载极其缓慢或失败 | 默认中央仓库不稳定 | 使用阿里云/华为云镜像替换central仓库 |
| 代码注释和字符串出现中文乱码 | 编码不是UTF-8 | Settings → File Encodings全部改成UTF-8 |
| 修改代码后IDEA不自动编译，运行时还是旧代码 | 构建方式配置问题 | Settings → Build → Build project automatically勾上；或按Ctrl+Shift+F10重新运行 |
| 版本控制面板不显示Local Changes | 项目未被识别为Git/SVN工作目录 | 检查IDEA是否识别到了仓库根目录，如果没有，VCS → Enable Version Control Integration |
| IDEA启动很慢，打开大项目卡顿 | 内存不足或索引没有完成 | 调大-Xmx参数，首次打开项目等待索引完成，之后就会顺畅 |
| 双击运行Tomcat时报端口被占用 | 8080端口被其他程序使用 | 命令行netstat -ano查占用进程，杀掉或改Tomcat端口 |
6.2 几个印象深刻的坑：个人实测记录
第一个坑是Maven源版本警告。新手从网上复制一个别人的pom.xml时，经常看到java: 警告: 源发行版 17 需要目标发行版 17。这个问题的根源是pom.xml里没有显式声明编译版本，Maven默认按JDK版本来的，但如果你设定的是17，而某些插件默认参数还是1.8，就会出现版本不一致。解决方式就是在pom.xml的<properties>里加两行：
<maven.compiler.source>17</maven.compiler.source> <maven.compiler.target>17</maven.compiler.target>加了以后，重新加载Maven项目即可。如果还不行，就去Settings → Build Tools → Maven → Runner里把JRE选成17，两处对齐才算彻底解决。
第二个坑是IDEA启动后一直转圈，左下角显示“Indexing…”几个小时都不结束。这种情况大多发生在大仓库或文件特别多的目录。遇到这个，先把项目里那些无所谓索引的目录排除掉，比如target、node_modules、build这些生成目录，右键Mark Directory as → Excluded。排除之后索引任务量会大幅下降，启动速度明显提升。
第三个坑是写代码时IDEA的提示键弹不出来，按Ctrl+Space没用。常见原因是输入法快捷键冲突，Windows上微软拼音、搜狗输入法都默认占用Ctrl+Space切换中英文，会把IDEA的补全快捷键抢走。遇到这种情况，要么去输入法设置里把按键改了，要么干脆习惯用Tab和Alt+Enter补全，IDEA的补全在输入字符时本来就自动弹，快捷键只是补充手段。这个坑特别隐蔽，很多人以为是软件坏了，实际上只是输入法捣乱。
6.3 关于多个JDK版本切换的管理心得
日常开发中，电脑上同时装了JDK 8和JDK 17是很常见的，老项目用8，新项目用17。IDEA支持在每个项目里单独设置JDK版本，操作是：File → Project Structure → Project → SDK，这里选择当前项目用哪个JDK；Module → Dependencies里也可以单独指定模块的JDK版本。也就是说，同一台机器共存多版本JDK完全没问题，只要每次新建项目时手动确认一下SDK版本就好。
环境变量层面的JAVA_HOME还是建议只指向一个最长用的版本，比如Java 17，而老项目要用JDK 8时，就全靠IDEA的SDK设置来控制。这样命令行工具和构建脚本默认走上统一版本，项目内部又各自为政，互不干扰。经常需要在命令行里切换版本的，也可以用jEnv这类工具来管理，但一般开发场景下IDEA自带的SDK选择已经足够了。
另外，某些顽固的构建脚本会通过JAVA_HOME环境变量获取JDK路径，如果IDEA设置对了而Maven运行还是报版本不对，可以去Maven Runner设置里把JRE改成项目的JDK版本，这一步很多教程都没提到，实际上是解决“项目里选对版本，一跑Maven又用错版本”这类问题的关键。
7. 多花十分钟，把这些效率和体验细节也搞定
7.1 必备插件推荐与安装方法
IDEA的插件市场是它的一大王牌。安装方法很简单：File → Settings → Plugins → Marketplace，搜索插件名，Install，重启生效。
我给你推荐几个我每天都会用到的插件，不贪多，个个都是刚需。Lombok，处理实体类注解必备，没有它你写Java Bean时还得手动生成大量getter/setter。Alibaba Java Coding Guidelines，阿里出品的代码规范检查工具，能顺手帮你揪出很多潜在Bug。JRebel，这个适合开发Web应用的人用，它能在不重启项目的情况下热加载代码，但它是收费插件，如果你只是学习期暂不用装。
还有一组是提效插件：CodeGlance Pro，在代码编辑器右侧生成一个迷你地图，滚动定位很方便；Rainbow Brackets，把括号和花括号染成不同颜色，嵌套层级一眼就能看清；Chinese Language Pack，如果你英文界面看着费劲，这是官方中文包，装上以后界面全面汉化，新手期比较友好。等用熟之后，建议再切回英文界面，因为很多技术文档、论坛截图默认是英文，对照着看不容易迷路。
7.2 IDE配置同步：换电脑不用重新折腾
JetBrains提供官方的Settings Sync功能，可以把你的IDE设置、配色、键盘映射、插件列表同步到JetBrains账号上。使用方式是：Settings → Settings Sync，勾选要同步的项目，登录JetBrains账号。注意社区版只有基础的Settings Sync功能，插件列表同步是支持的。这样换电脑、重装系统以后，登录账号选覆盖本机设置，几分钟就能恢复你熟悉的工作环境。
如果你不想注册JetBrains账号，也可以手动备份配置目录。Windows上配置一般在C:\Users\用户名\AppData\Roaming\JetBrains\下，macOS在~/Library/Application Support/JetBrains/下，整个文件夹拷走，放到新机器同路径，即可恢复大部分设置。用Settings Sync更方便，手动备份更可控，两种方式看个人偏好。
7.3 AI辅助功能与代码提示
现在IDEA的新版本已经内置或可通过插件接入AI助手。2026.x版本里，JetBrains官网提供了官方AI Assistant插件，可以补全代码、生成注释、解释报错信息。另外你也可以通过OpenAI兼容的接口插件把常用大模型接进IDEA对话框，让它在你选中代码后直接给重构建议。这些功能在写业务代码、写单元测试时非常省时间，但我建议只在不太复杂的场景下使用AI建议。AI生成的代码偶尔会有隐蔽的逻辑问题，尤其是并发、IO、资源释放这类场景，可靠性还得靠人审。
接入AI时注意一点：不要把公司内部未开源的代码无脑粘贴到公网AI服务里，数据安全红线不能碰。自己学习项目里随手用没关系，工作项目里要看公司规定，很多企业对代码上云有严格限制，聪明人不会在这上面踩坑。
收尾时几句掏心窝的话
安装IDEA这件事，技术难度其实不高，但每个环节都藏着一些很容易绊倒人的细节。我从第一次装IDEA到现在，帮别人解决过的环境问题没有一百也有八十，很多问题翻来覆去都是那几个根源：环境变量没配置好、编码不是UTF-8、Maven镜像不通、JDK版本不对齐。这篇指南把这些点都摊开讲透了，严格照着走，理论上半小时内就能从零到能跑起一个Spring Boot项目。
我个人在实际操作中的一点体会是：装好工具只是第一步，真正拉开差距的是你愿不愿意花时间去搞懂IDEA每个弹窗在问什么、每条快捷键在做什么。很多人遇到不懂的提示直接乱点跳过，几年下来还是只会写代码、不会用IDE。反过来，你把项目结构、构建工具、版本控制这些IDE底层东西弄明白了，以后换任何一个工具、任何一门语言，都能比别人上手快得多。先把环境弄扎实，这是所有Java学习里性价比最高的一件事。
