IntelliJ IDEA 2026安装配置全指南:从JDK到Maven再到Tomcat

每年到了新版本发布节点,我后台都会收到一大批关于“IDEA 下载”“IDEA 安装”的私信,今年也不例外。其实装 IntelliJ IDEA 本身不难,难的是装完以后那些让人一头雾水的配置:JDK 怎么加、Maven 为什么下载慢、Tomcat 到底在哪配、项目建完怎么跑不起来。这篇就把 IntelliJ IDEA 从下载、安装到日常使用一条龙讲清楚,以 2026 年的最新正式版为基准,照着做,一个小时内把开发环境完整搭起来不是问题。

这篇内容适合刚入行的 Java 开发、学生党,也适合一直用 Eclipse 想转 IDEA 的老手。社区版和旗舰版的差别、官网怎么找、安装向导里每个选项该不该勾、JDK/Git/Maven/Tomcat 怎么接、新手最容易踩的几个坑,全都放在下面,一次讲透。

1. 别急着下载:先搞清楚社区版和旗舰版该怎么选

很多新手上来就搜“IntelliJ IDEA 下载”,下载完打开才发现原来是社区版,功能少了一截;也有些人一搜就进了带“破解版”字样的网站,装完电脑卡到傻,后台还跑着一堆莫名其妙的东西。这个顺序其实反了,选版本和选授权方式比下载本身更重要,值得先花几分钟理清楚。

1.1 社区版和旗舰版的真实差别

IntelliJ IDEA 主要分两个发行版:Community(社区版)和 Ultimate(旗舰版)。社区版完全免费,任何人都可以直接从官网下载使用;旗舰版是收费订阅产品,提供完整的企业级开发功能。

能力维度Community 社区版Ultimate 旗舰版
Java / Kotlin / Groovy / Scala 基础开发支持支持
Maven / Gradle 构建支持支持
Git / SVN 版本控制支持支持
Spring / Spring Boot / Jakarta EE不支持支持
Tomcat / Jetty / 应用服务器集成不支持支持
数据库工具(Database 面板)不支持支持
JavaScript / TypeScript 前端开发基础支持完整支持
JSP / Web 相关高亮与调试不支持支持
远程开发 / 网关客户端有限完整

从这张表能直接看出来:如果你只是单纯写 Java 基础代码、做算法题、跑普通项目,社区版完全够用,而且不花一分钱。但如果你要学 Spring Boot、要做 Web 开发、要在 IDEA 里直接配置 Tomcat,那至少需要一个临时旗舰版授权,或者在社区版里走其他流程绕过去。

1.2 免费和低价获得正版授权的正经渠道

旗舰版虽然是收费的,但拿到正版授权的正经渠道其实不少,没必要一上来就想着去搜网上流传的“激活码”。

  • 30 天试用:装好旗舰版后,选择 Start trial,按提示登录或注册 JetBrains 账号即可开始试用。试用期内功能完整,适合短期做项目或者评估是否值得付费。
  • 教育邮箱注册:学生和教师用学校官方邮箱在 JetBrains 官网完成学历验证后,可以免费使用包括旗舰版在内的所有桌面产品,期限覆盖整个在校阶段。每年都有很多同学卡在验证环节,实际就是用带 edu 后缀或学校官方邮箱收一封验证邮件,点链接即可。
  • 开源项目授权:如果你在维护一个活跃的开源项目,可以在 JetBrains 官网申请免费的开源开发授权。
  • 个人付费订阅:按年订阅,价格在 IDE 产品里不算低,但对全职开发者来说属于生产力投资。公司报销的话直接让公司买,别自己硬扛。

我个人的建议是:在校生首选教育邮箱注册,直接解锁旗舰版所有功能;非在校且暂时不想付费,先用社区版练手,基础 Java 开发不会有任何障碍;如果确实需要旗舰版功能又不想掏钱,那就用官方试用,到期就停,别走歪路。

1.3 为什么我不建议碰“激活码”和“破解版”

必须把话说重一点:网上那些标着“IntelliJ IDEA 破解版”“激活码生成器”的下载站,是新手最容易踩的坑,而且踩进去的代价远超几十上百块的订阅费。

首先,安全风险极大。这类安装包经常捆绑木马、挖矿程序、浏览器劫持插件。你装完 IDEA 发现电脑风扇狂转,以为是 IDE 编译导致的,其实是后台挖矿程序在跑。这类案例每年都有,损失的不只是电脑性能,还有账号密码和代码泄露的可能。

其次,破解版或通过非正规渠道获取的授权无法享受官方插件市场、官方更新和技术支持。一旦遇到插件装不上、版本升级后崩溃的问题,你会发现网上的正常教程全都对不上号,因为你的 IDE 本身就是个畸形版本。

最后,存在版权和使用合规问题。很多公司现在非常重视软件正版化,入职后员工私自使用破解软件,一旦被扫描到,轻则谈话,重则影响工作。这个风险没必要替自己背。

社区版免费 + 教育授权 + 官方试用,这三条路已经覆盖了绝大多数人的需求,真的没必要在“破解”这件事上浪费时间。

2. 官网下载实操:认准官方域名,避开捆绑下载站

确定好版本和授权方式之后,下一步就是下载安装包。这一步看似简单,却是新手翻车重灾区。搜索引擎第一页往往混着大量下载站广告,点进去全是“高速下载”“破解版专用”,下载回来的东西对不对自己完全不清楚。

2.1 怎么找到真正的官网

认域名是最简单的办法。IntelliJ IDEA 的官方产品页在 JetBrains 官网上,主要域名就是jetbrains.com。你要找的地址是:

https://www.jetbrains.com/idea/

这里有个小技巧:在搜索引擎里搜“IntelliJ IDEA”时,先看搜索结果条目下方的来源域名再点。只要不是jetbrains.com官方域名的,不管标题写得多诱人,都建议绕开。另外注意,很多下载站的页面做得和官网很像,连 logo 都差不多,唯一的破绽就是地址栏里的域名。

手机端也一样,收到任何“IDEA 更新包下载”的短信或邮件链接,先看域名,非jetbrains.com一律不看。

2.2 下载页面上的几个选择怎么选

打开官方下载页后,你会看到当前最新正式版的大按钮,旁边通常有 Community 和 Ultimate 两个选项卡,页面上还会区分操作系统。

操作系统下载文件格式说明
Windows.exe双击直接运行安装向导
macOS.dmg拖拽到 Applications 即可
Linux.tar.gz解压后进入 bin 目录运行 idea.sh

这里有几个选择你需要确认:

第一,选 Ultimate 还是 Community,跟你第 1 章的决策保持一致。下载页默认显示的可能是当前阅读区域,仔细看选项卡是否已经切换到你想要的那个版本,别下错。

第二,系统架构选择。新版 IDEA 同时提供 x86_64 和 ARM64 两种安装包。绝大多数 Windows 电脑是 x86_64;如果你是 Apple Silicon 芯片的 Mac,选 ARM64 / Apple Silicon 的版本执行效率和耗电表现更好。Windows 上如果不确定自己电脑是什么架构,按Win+R输入msinfo32回车,看“系统类型”里写着基于 x64 还是 ARM 即可。

第三,下载 Toolbox App 还是独立安装包?Toolbox 是 JetBrains 全家桶管理工具,能安装、升级、回滚所有 JetBrains IDE,多版本切换非常方便。如果你只装一个 IDEA,建议直接下载独立安装包,清爽省事;如果你打算以后还要 PyCharm、GoLand、WebStorm 一起用,那直接用 Toolbox 管理更方便,升级的时候不用逐个重新下载。

第四,历史版本怎么选。下载页面主按钮通常指向最新正式版。如果你所在团队的插件还不兼容最新版,或者刚发布的新版有已知问题,可以进入 Previous Versions 页面,选择上一个正式版,通常更保险。EAP 版是早期预览版,除非你想尝鲜,否则不要选。

2.3 下载慢、下到一半断掉怎么办

IDEA 安装包在 700MB 到 1GB 左右,体积不算小。国内网络环境下载官方包时确实可能遇到速度慢或中断的情况,这属于正常现象,不需要去折腾什么额外的工具。

  • 换一个网络环境。公司网络限速就切到手机热点,校园网限速就找室友借个热点,多数情况下速度马上有变化。
  • 错峰下载。工作日晚高峰下载官方服务器容易慢,改成早上或者深夜一般会好很多。
  • 用浏览器自带的下载功能,不要用那些第三方“高速下载器”。IDEA 安装包官方下载本身就支持断点续传,下到一半断了,点重试会继续,不用从头再来。

还有一点很重要:下载完成后核对一下文件是否完整。可以在资源管理器里看压缩包或 exe 的体积是否和官网标注一致,明显偏小就删除重下。不要从第三方网站下“绿色版”“免安装版”,这类重新打包过的版本出问题概率极高。

3. Windows 安装全流程:从安装向导到第一次启动

安装包下载完成后,双击运行,下面每一步的选择都会影响之后的使用体验。我按 Windows 环境走一遍,macOS 用户大同小异,路径和按钮位置稍有差别,但逻辑一致。

3.1 安装向导里每个勾选项的对与错

IDEA 的安装向导整体很简洁,从启动到完成也就几分钟,但中途有两屏需要你认真看。

第一屏是安装路径选择。默认是C:\Program Files\JetBrains\...,没特殊需求就保持默认。你自己想改到 D 盘也没问题,但记住一个原则:安装路径不要出现中文,也不要用带空格的奇怪目录。虽然新版 IDEA 对空格路径支持得不错,但后续接 Maven、Tomcat、脚本工具时,路径里的空格和中文字符偶尔会惹出莫名其妙的问题。

第二屏是安装选项,这才是重点。这里会列出几个复选框:

  • Create Desktop Shortcut:建议勾选,创建桌面入口,不然每次都要去开始菜单找。
  • Update PATH variable(restart needed):建议勾选。它会往系统 PATH 里加入 IDEA 的启动命令,之后随时可以在命令行里敲idea .直接打开当前目录下的项目,用惯了很顺手。
  • Update context menu:建议勾选。右键任意文件夹菜单会多出“Open Folder as IntelliJ IDEA Project”,对日常打开项目特别方便。
  • Create Associations:勾选.java文件关联,双击 .java 文件直接用 IDEA 打开。这个看个人习惯,我个人会勾上。
  • Download and install JBR:JetBrains Runtime 通常内置在安装包里,不需要额外勾选。

安装类型方面,新版 IDEA 不会像老版本那样反复问你“Default”还是“Custom”,基本就是一套流程走完,普通用户不需要做太多定制化改造。

3.2 第一次启动时的关键界面选择

安装完成,首次启动会先看到一个欢迎窗口:

  • 如果你电脑上装过老版本 IDEA,可以选择导入上一版本的配置;如果是全新安装,选“Do not import settings”从零开始,避免旧配置里的坑被带过来。
  • 之后是主题选择界面,默认提供 IntelliJ Light 和 Darcula 深色主题。建议直接用 Darcula,长时间写代码眼睛更舒服,当然这个完全看手感。
  • 再往后就是激活窗口。社区版这里会直接进入社区版欢迎界面,不需要激活;旗舰版会显示登录或试用入口。如果你有教育邮箱授权,直接 Log in to JetBrains Account 登录账号即可自动授权,无需额外输激活码。

初次启动加载会比较久,进度条卡在某一处很久也不用慌,特别是机械硬盘或低配电脑上,耐心等一会儿就行。

3.3 先把 JDK 安好,后面少走弯路

IDEA 本身自带 JBR(JetBrains Runtime),所以 IDE 程序能正常启动,但这不等于你可以直接创建 Java 项目。创建、编译、运行 Java 代码需要独立的 JDK(Java Development Kit),这一步不准备好,后面建项目时就会看到类似的报错:

Error: java: invalid source release: 17

或者 Project SDK 下拉框里什么都没有。

JDK 版本选择上,2026 年这个时间点建议优先使用 LTS 长期支持版本。Java 17 和 Java 21 都是稳妥选择,如果用的框架要求更高,再考虑更新的 LTS。不建议一上来就追最新非 LTS 版本,很多第三方库和插件未必跟得上。

JDK 从哪下载?两个主流途径:

  • Oracle JDK:官方地址oracle.com/java/technologies/downloads/,下载前需要勾选接受许可协议,版本更新及时。
  • OpenJDK 发行版:推荐 Eclipse Temurin(adoptium.net)、Azul Zulu(azul.com),开源免费,企业用得也很多。

Windows 上推荐下载.msi或.exe安装包,安装时可以勾选“设置 JAVA_HOME 环境变量”和“将 java 加入 PATH”。装完后打开命令行验证:

java -version javac -version

能看到版本号输出,说明 JDK 已就绪。这一步跑不通的话,优先检查环境变量。安装 JDK 时路径同样不要有中文。

4. 让 IDEA 进入工作状态:JDK、Git/SVN、Maven、Tomcat 逐个配齐

安装完成只是第一步,真正的工作要等 IDEA 和本地的开发工具链配好才开始。这一节按实际使用频率排序,把最常用的几个配置项全部过一遍。

4.1 在 IDEA 里配置 JDK,项目 SDK 不能再乱

JDK 在系统层面装好之后,IDEA 里还要做一次对接,因为每个项目都要明确自己用哪个 JDK。

打开 IDEA 后,按Ctrl+Alt+Shift+S打开 Project Structure(项目结构)窗口,左侧选 Project,右侧的 SDK 一栏如果空着,点 New,选择 JDK,然后定位到你 JDK 的安装目录。Windows 上 Oracle JDK 默认一般在:

C:\Program Files\Java\jdk-21

点确定后,SDK 栏会出现对应的 JDK 版本,接着在下面的 Language Level 里选择一个匹配的版本。一般保持默认即可,设得比 JDK 实际版本低会导致认不出新语法,设得高而实际 JDK 太老又会报错。

这一步配好之后,新建项目时选择 Project SDK 就会自动带出你添加过的 JDK,不需要每个项目都手动找一遍。

4.2 Git 和 SVN 接入:版本控制工具的路径设置

IDEA 自带的 Version Control(版本控制)功能非常完善,前提是它得能调用你本地的 Git 或 SVN 客户端。

Windows 上建议先到 Git 官网下载 Git for Windows,安装一路 Next 即可,注意安装过程中选择“Git from the command line and also from 3rd-party software”这个选项,确保git命令在系统里全局可用。

安装完成后打开 IDEA,按Ctrl+Alt+S打开设置,左侧找 Version Control,再进入 Git 子页。右侧 Path to Git executable 这里,IDEA 一般会自动检测到C:\Program Files\Git\bin\git.exe。如果没检测到,点后面浏览按钮手动指向这个路径,然后点 Test,看到版本号就说明 Git 接入成功。

SVN 的配置方式一模一样,先在电脑上装好 TortoiseSVN 或官方 Subversion 客户端,然后在 Version Control 的 Subversion 页里设置命令行客户端路径。配置完成后,从 SVN 检出项目、提交代码、查看 diff 都直接在 IDEA 面板里操作,不需要切回第三方客户端。

有一点要提醒:如果项目之前没有.git目录,IDEA 的 Git 面板很多功能是灰色不可用的,需要你先通过VCS > Enable Version Control Integration把项目纳入 Git 管理,后面我还会细讲。

4.3 Maven 配置:本地仓库、镜像源、相对路径

Maven 是 Java 项目最常用的构建工具。IDEA 内置了 Maven,但它内部默认配置不一定适合国内网络环境,所以我们要做的就是把自己准备的一份 Maven 配置交给 IDEA,或者调整内置配置。

推荐的做法是自己下载一份 Maven 解压到本地目录,比如D:\software\apache-maven-3.9.x,然后改它的配置文件conf\settings.xml。

第一件事是设置本地仓库位置。默认仓库在用户目录.m2\repository下,系统盘空间不够的话很容易爆。建议指定到 D 盘:

D:/software/maven-repo

第二件事是配置国内镜像源。Maven 默认从中央仓库下载依赖,国内直连速度时常让人抓狂,配置阿里云公共仓库镜像可以明显改善:

aliyunmavencentralAliyun Maven Repositoryhttps://maven.aliyun.com/repository/public

这段配置放在settings.xml的节点内,保存即可。

然后在 IDEA 中按Ctrl+Alt+S,进入 Build, Execution, Deployment > Build Tools > Maven:

  • Maven home path:选你解压的 Maven 目录,注意选到根目录而不是 bin 目录。
  • User settings file:勾选 Override 后,指向你的settings.xml。
  • Local repository:勾选 Override 后,自动读取settings.xml里的localRepository地址。

配完之后新建 Maven 项目,导入依赖的速度会有质的提升。这一步在很多教程里被忽略,不配镜像源的话,新手第一个 Spring Boot 项目等依赖就要等半小时,非常打击信心。

4.4 Tomcat 配置:评论区问得最多的环节

搜索记录里关于“IDEA 配置 Tomcat”相关问题非常多。在开始之前必须讲清楚一个前提:Tomcat Server 集成只存在于旗舰版。如果你用的是社区版,Run/Debug Configurations 里找不到 Tomcat Server 选项,这不是你配置错了,而是社区版本来就不带这个功能。

在旗舰版中,配置 Tomcat 的完整步骤如下:

第一步,下载 Tomcat。去 Tomcat 官网选择对应版本,注意和 JDK 的兼容性:Tomcat 10 需要 JDK 11 以上,Tomcat 11 需要 JDK 17 以上。下载完成后解压到本地目录,同样建议不要放在带中文或空格的路径下。

第二步,在 IDEA 中打开 Run > Edit Configurations,左上角加号,下拉找到 Tomcat Server,选择 Local。

第三步,在 Server 标签页,点击 Configure 按钮,弹出 Application Servers 窗口,把 Tomcat Home 指向刚才解压的 Tomcat 目录。IDEA 会自动识别版本号,点击 OK。

第四步,回到配置窗口,可以看到 Name 可以随意起,Server Settings 里的 URL 默认是http://localhost:8080/;HTTP port 默认 8080,如果 8080 被占用就改成 8081、8082,改动后下方 URL 会自动同步。

第五步,切到 Deployment 标签,点加号,选择 Artifact,然后在弹出的窗口里选择xxx:war exploded格式。这里特意要说一下 war exploded 和 war 的区别:war exploded 是解压目录,开发时部署快、支持热更新;war 是标准压缩包,适合最终发布。日常开发选 war exploded 就够了,不需要打成 war。

配置完成后点运行按钮,IDEA 下方会弹出 Tomcat 日志窗口,看到类似下面的输出说明启动成功:

Artifact is being deployed, please wait... [INFO] Starting Servlet Engine: Apache Tomcat/11.0.x

浏览器访问http://localhost:8080/项目名/,能看到你的页面就全部配通了。

如果你用的是社区版,又想跑 Tomcat,可行的替代方案是:把项目打成 war 包放到 Tomcat 的 webapps 目录下,然后手工启动 Tomcat。但这样开发效率很低,所以想系统学 Java Web 的同学,还是建议先用教育邮箱或试用期拿一个旗舰版授权。

5. 新建一个能跑起来的项目:普通 Java 和 Spring Boot 都走一遍

环境配完,是时候验证一下整条链路能不能正常工作了。这一节用两个典型项目做演示:一个最朴素的 Java 控制台程序,一个 Spring Boot Web 项目。

5.1 创建并运行一个最普通的 Java 项目

打开 IDEA,点击 Welcome 界面上的 New Project。在弹出的对话框里:

  • 左侧选 New Project 或直接选 Java。
  • Name 填项目名,比如hello-world。
  • Location 是项目保存路径,自己选个方便找的地方。
  • Build system 选 IntelliJ 平台自带即可,或者选 Maven。如果选 Maven,IDEA 会自动生成 pom.xml 和标准目录结构;如果选平台自带,目录更精简,适合写简单测试代码。
  • JDK 下拉框选择你之前配好的 JDK 版本。
  • 点击 Create 创建。

创建完成后,展开src目录,右键new > Java Class,输入类名Main,IDEA 会自动生成一个类骨架。补上主方法:

public class Main { public static void main(String[] args) { System.out.println("Hello, IntelliJ IDEA!"); } }

左侧类名旁会出现一个绿色三角运行按钮,点击它或按Ctrl+Shift+F10,下方 Run 面板就会输出:

Hello, IntelliJ IDEA! Process finished with exit code 0

出现这行输出,说明 IDEA 的安装、JDK 配置、项目创建整条链路已经没有任何问题。

5.2 社区版建 Spring Boot 项目的两条路

Spring Boot 项目就比较特殊了,旗舰版里可以直接通过 Spring Initializr 向导创建,社区版没有这个入口。但社区版仍然可以做 Spring Boot 开发,只是建项目的方式要绕一下。

第一种方法:去 Spring Initializr 官网start.spring.io生成项目压缩包。页面选项按需填写:

  • Project:Maven
  • Language:Java
  • Spring Boot:选一个 2026 年当前可用的正式版
  • Group:比如com.example
  • Artifact:比如demo
  • Dependencies:搜索并添加 Spring Web

点击 Generate 按钮下载一个 zip 包。解压后在 IDEA 里选择 Open 或 Import Project,定位到解压后的目录,IDEA 识别到 pom.xml 后会自动等待 Maven 下载依赖。等右下角进度条跑完,项目就导入完成。

第二种方法:在电脑上装了 Maven 之后,手动创建 pom.xml 和目录结构,然后在 IDEA 里以 Maven 项目方式打开。这个方法费手但是能帮你彻底理解 Maven 项目的结构。

项目导入后,找到src/main/java/com/example/demo/DemoApplication.java,这个类上有@SpringBootApplication注解,点击旁边的运行按钮,控制台出现类似下面的内容就说明 Spring Boot 启动成功:

Tomcat started on port 8080 (http) with context path '/' Started DemoApplication in 2.5 seconds

此时浏览器打开http://localhost:8080,虽然现在返回的是一个 Whitelabel 错误页面,但 Tomcat 确实已经跑起来了。再配合前面配置的 Tomcat 集成,开发 Java Web 项目的完整环境就齐了。

5.3 项目跑起来之后,这几个日常操作值得记住

环境搞定之后,IDEA 里有一些高频操作需要提前熟悉,能省下大量时间。

  • 自动导入:Maven 项目首次加载时,IDEA 右下角会提示 Maven projects need to be imported,建议勾选 Enable Auto-Import,以后 pom.xml 改动后依赖自动更新。
  • 热更新:对 Spring Boot 项目,可以在 pom.xml 里引入 spring-boot-devtools,改完代码后 IDEA 会自动重启应用,不用每次手动点重启按钮。
  • 全局搜索:按两次Shift可以搜任何类、文件、配置项;Ctrl+Shift+F是全文搜索,Ctrl+Shift+R是全局替换,这三个快捷键建议刻进肌肉记忆。
  • 重构重命名:Shift+F6重命名变量、类、文件名,IDEA 会自动同步所有引用位置,比手动改安全得多。

这些操作不是为了炫技,而是实打实影响日常效率的手段。新环境搭好之后,花十分钟把常用快捷键过一遍,收益远大于投入。

6. 高频踩坑实录:Win7、插件联网、JSP 高亮、Git 面板逐个排查

无论安装教程写得多详细,真正实践时还是会遇到各种报错和反直觉的现象。这一节我整理了这几年在社区里被问得最多的几类问题,个个都有真实场景。

6.1 Windows 7 实在装不上新版怎么办

搜索记录里“intellij idea win7”这个关键词反复出现,可以判断还有不少老机器停留在 Windows 7。需要明确一点:JetBrains 从 2021.2 版本开始就不再支持 Windows 7,之后的所有版本都无法在 Win7 上正常安装或运行。

如果你现在必须用 Win7 环境,唯一的选择是下载 2021.1 或更早的版本。但这里要劝一句:老版本 IDEA 不仅功能落后,而且存在大量已知安全漏洞,插件市场也不再提供服务,用来做正经项目风险很高。如果条件允许,强烈建议把系统升级到 Windows 10(21H2 以上)或 Windows 11。

顺便提一下,IDEA 新版对 Windows 10 和 Windows 11 的最低要求也在慢慢提升。2026 年的版本在 Win10 老版本上开始出现各种奇怪的显示问题,所以系统本身保持更新同样重要。

6.2 插件提示连不上插件市场

这是另一个高频问题,现象是打开 Settings > Plugins,搜索框转到半圈然后提示连接插件市场失败,或者搜索出来的插件点击安装按钮就卡住,最后报“Cannot download”。在网上看到“IDEA 插件安装感觉没法联网”这类描述,基本就是这个问题。

先检查基础网络。插件市场服务域名是plugins.jetbrains.com,在浏览器里直接访问这个地址,如果能打开但不流畅,说明网络连通性没问题,只是插件市场和 IDE 之间的连接不稳定;如果浏览器也打不开,就要排查本地网络环境了。

比较实用的处理办法是手动安装插件:在浏览器打开 JetBrains 插件市场网站,搜索需要的插件,在页面右侧选择对应 IDEA 版本,下载 zip 文件;然后回到 IDEA,Settings > Plugins,点右上角齿轮按钮,选择 Install Plugin from Disk,定位到刚才下载的 zip 文件,重启 IDEA 即可。

这个方法绕开了 IDE 内部的插件下载机制,成功率很高。需要注意下载时一定选对 IDEA 版本,否则插件启动时会报不兼容。

6.3 Color Scheme 里找不到 JSP 高亮

有同学在 Settings > Editor > Color Scheme 里找 JSP 的语言高亮配置,结果语言列表里根本没有 JSP 这一项。这个问题的根源不在 Color Scheme,而在更上层的插件和版本支持。

JSP 的语法高亮属于 Java Web 开发支持的一部分,社区版里这个功能本来就没有完整提供。如果你用的是社区版,找不到 JSP 高亮选项是正常的,因为社区版不包含 Jakarta EE / Web 相关的语言插件,自然也不会在 Color Scheme 列表里出现 JSP。

如果你用的是旗舰版但仍然找不到,打开 Settings > Plugins,搜索“Java Web”或“Servlet”相关插件,检查是否被误禁用状态。旗舰版默认会启用 Java EE、Web、Servlet、JSP 相关插件,一旦这些插件被关闭,JSP 文件会变成纯文本,Color Scheme 里对应语言也会消失。重新启用后重启 IDE,JSP 的高亮和支持就回来了。

6.4 Git 工具窗口里没有 Local Changes

这个情况在 2025、2026 新版 IDEA 里出现得比较多:项目打开了,底部 Git 工具窗口却只有 Log 和 Branches,Local Changes 选项不见了。

先排查一个最常见原因:项目根本没有纳入 Git 版本控制。新建项目时如果没选 Git 初始化,项目目录下就没有.git文件夹,IDEA 不认为这是一个 Git 仓库,自然不会显示本地变更。处理办法是:菜单栏 VCS > Enable Version Control Integration,选择 Git;然后回项目里看文件,IDEA 会标记出未被跟踪的文件,右键项目选择 Git > Add,把它们加入暂存区。

如果确认项目已经在 Git 仓库里,对应目录也有.git,但 Git 工具窗口依然没有 Local Changes,那大概率是新版界面把入口收起来了。新版 IDEA 将变更列表合并进了 Commit 工具窗口,点击右侧边栏的 Commit(快捷键Alt+0),可以看到当前所有修改过的文件,效果和以前的 Local Changes 一致。不明白这个改动的用户,很容易误以为功能缺失。

6.5 关于 AI 插件和接入大模型的注意事项

2026 年的 IDEA 版本对 AI 编程助手的支持已经非常成熟,插件市场里既有 GitHub Copilot 这样的国际产品,也有不少国产 AI 助手,比如通义灵码、Kimi 等。很多同学装完这类插件后发现请求不发、回复不出来,第一反应是插件问题,其实大部分原因还是和 6.2 提到的插件安装、网络连通性问题同源。

AI 插件本质上要调用远程大模型接口,如果请求发不出去,可以从这几个角度排查:确认插件已登录且授权有效;确认当前网络环境能正常访问插件对应的服务接口;检查 IDE 输出日志中有没有超时或 401、403 错误。企业内网或校园网经常有额外限制,遇到这种情况建议先咨询网络管理员是否对特定域名做了访问控制。

接入 Kimi 或通义这类国产助手时,一般按照插件官方文档配置 API Key 或扫码登录即可,不需要在 IDEA 里改额外参数。如果插件市场搜索不到这些插件,就按 6.2 的手动安装方式从插件市场网站下载 zip 安装。

我自己每次帮人排查完环境问题,都会顺带看一眼他的插件列表。装了几十个插件而经常出问题的人,往往不是插件不支持新版本,就是插件之间产生了冲突。最省心的做法是保持插件数量精简,能不用就先不用,真正需要再装,遇到异常优先禁用最近新增的插件确认原因。这样排查问题的半径会小很多,等你积累到上千个项目量级的时候,会发现维护一个干净、可复现的开发环境,比追求“全家桶”有价值得多。