如果你打算开始写 Java或者你所在的项目组要统一 IDE那IntelliJ IDEA Community这个名字你多半绕不过去。它是 JetBrains 家出的免费 Java 集成开发环境跟收费的 Ultimate 旗舰版同宗同源日常写 Java 后端、练算法、做课程设计、维护一些小工具完全够用。这篇教程我就按照实际动手顺序来写从下载安装、JDK 配置、创建第一个 Java 项目到集成 Tomcat、SVN/Git再到我这些年踩过的坑。里面所有步骤都是我自己装过的、截图确认过路径的不会让你走到一半发现菜单对不上。先说结论Community 社区版虽然免费但不是阉割版的 Java 学习工具。它只是砍掉了企业级框架的专属支持和部分前端工具核心编辑器、调试器、Gradle/Maven、Git/SVN 集成、单元测试全部保留。对大多数个人开发者、学生、中小型后端项目社区版是性价比最高的起点。1. 先搞清楚再动手Community版和Ultimate版到底差在哪1.1 版本差异对比很多新手刚接触 IntelliJ IDEA 时看到官网有两个下载按钮就懵了。左边Community Edition免费右边Ultimate收费明明看起来一样为什么还要分两个版本其实这是因为 JetBrains 把 IDE 分了产品线Ultimate是完整功能的 Java IDECommunity则是把 Java 开发最基础、最常用的功能抽出来做成的免费版。两者的内核、界面、快捷键、调试体验完全一致区别主要在上层功能覆盖范围。我整理了一张实际使用中感知最明显的差异表功能点Community 社区版Ultimate 旗舰版价格免费Apache 2.0 许可证商业订阅按年付费Java/ Kotlin/ Groovy 开发完整支持完整支持Maven / Gradle完整支持完整支持Git / GitHub / SVN完整支持完整支持调试器 / 测试框架完整支持JUnit等完整支持Spring / Spring Boot 专有支持不支持可手写配置支持项目向导一步生成JavaEE / Web 应用服务器不支持需配合插件支持可视化部署数据库工具Database面板不支持可装插件内置完整版前端 JavaScript / TypeScript仅基础语言支持完整支持含Node.js等代码重构 / 智能提示有且相当强有且多出框架相关提示UML / 架构图不支持支持如果你只是拿来做 Java 基础练习、算法刷题、写命令行小程序那Community 版和Ultimate 版在你日常工作里几乎没有区别。但如果你要开发 Spring Boot 微服务、连数据库可视化操作、管理前端工程那Ultimate的专属支持确实能省不少时间。1.2 为什么我建议新手用 Community版我的建议很直接如果你不是公司的商业项目需要也不是被逼着用 MyEclipse 这种老古董的老员工从Community开始是最好的选择。理由有四个。第一免费合法。很多人一搜IntelliJ IDEA 下载出来的全是激活码破解教程。说实话看着很吓人也完全没有必要。Community 版本身就能覆盖绝大多数学习场景你不需要用盗版工具去学编程。这既安全也省心。第二官方持续更新。JetBrains 对Community社区版的态度是认真维护的每年多个版本迭代新 JDK 出来后很快会支持。你不会因为用免费版就被落下反而能用上最新的语法特性和性能优化。第三社区资源丰富。你在 CSDN、Stack Overflow、B站搜IntelliJ IDEA 教程90% 的操作在Community上同样适用。越大众的选择越容易找到答案。第四从免费版升到收费版不会有学习成本。等你以后真需要 Spring Boot 的专属支持时装个Ultimate界面和快捷键照样熟悉只是多了菜单项而已。所以别再纠结免费的够用吗这类问题先装起来才是正事。2. 下载和安装先别急着点Next这几个选项最好看一眼2.1 官网下载与版本选择下载地址就是 JetBrains 官网的 IntelliJ IDEA 产品页。进入页面后你会看到两列下载卡片左侧写着Community Edition右侧写着Ultimate。这里要注意别点错很多人一激动就点了右边那个。点Community Edition卡片上的 Download 按钮页面会自动根据你的操作系统推荐安装包。Windows 环境一般下载.exe安装程序macOS 下载.dmgLinux 下载.tar.gz压缩包。如果你用的 Windows 是 64 位系统默认的Windows x86_64安装包就行。老的 32 位机器建议直接放弃IDEA新版本早就放弃 32 位支持了强行安装只会跑出一堆莫名其妙的错误。下载安装包的时候我建议选择不包含 JRE 的版本这里多说一句。IDEA安装包默认自带一个JBRJetBrains Runtime也就是 JetBrains 定制的 JRE。这意味着你即使没单独装 JDK也能打开 IDEA 的界面。但真正创建 Java 项目时系统还是需要一个标准 JDK这个后面单独讲。现在装的时候保持默认选项即可不用操心 JBR 的事。截至本教程写作时官方主流的版本主要通过 Toolbox App 或独立安装包两种方式提供。Toolbox App 相当于一个管理工具可以统一安装、升级、回退 JetBrains 全家桶。如果你是那种以后还想试试 PyCharm、WebStorm的人我反而推荐直接用 Toolbox省得每个产品都单独下载。但如果只想用 IDEA 一个产品独立安装包更干净路径可控也不会被 Toolbox 的自动更新打扰。2.2 安装向导的细节选项双击.exe后安装向导就会出来。这一步跟大多数 Windows 软件类似但有几个选项值得细看。路径选择默认在C:\Program Files\JetBrains\IntelliJ IDEA Community Edition 202x.x。如果你 C 盘空间紧张可以改到D:\IntelliJ IDEA Community。这里有一个建议安装路径最好全部是英文字符不要带中文或空格免得后面 Maven、Tomcat 等工具关联时路径解析出问题。下一步会出现三个关联选项Create Desktop Shortcut创建桌面快捷方式64-bit launcher 勾选即可。Update PATH variable把 IDEA 启动命令加入系统 PATH。除非你确实想用命令行idea启动它否则没必要勾选避免污染环境变量。Update context menu右键文件时出现 Open Folder as IntelliJ IDEA Project 的选项。这个有时候挺方便的双击某个文件夹就能用 IDEA 打开项目建议勾选。Create Associations关联.java等文件扩展名。我建议勾选.java这样双击.java文件时能直接用 IDEA 打开。接下来就一路 Next等进度条走完点击 Finish。此时还没有完全结束——首次启动前最好确认一下系统的 JDK 环境否则新项目创建时会卡在 SDK 选择阶段。2.3 安装完成后的首次启动安装完第一次启动时IDEA 会让你选界面主题Darcula是深色主题IntelliJ Light是浅色主题。这里凭个人喜好选就行后面可以在Settings → Appearance里随时切换。然后它会问你是否要导入之前版本的自定义设置。如果是全新安装选 Do not import settings直接进入默认界面即可。接下来有个可能让新人迷惑的窗口Customize IDEA左边一排是插件推荐、界面字体、调试字体等入口右下角可以进入 IDE。这里并不需要做任何复杂操作直接点Start Using或继续下一步就行。启动后稍等片刻你会看到 IDEA 的欢迎界面上面有New Project、Open、Get from VCS等入口。到这步IDE 的安装才算真正完成。3. 环境配置JDK、目录与常用设置3.1 什么是JDK怎么装虽然 IDEA 自带了一个运行用 JRE但创建一个 Java 项目时IDE 还是需要一个完整的JDKJava Development Kit。JDK 是 Java 开发工具包里面包含编译器javac、运行时java命令、核心类库等一系列工具。你可以把 JDK 理解成建材市场IDEA 是施工队施工队要盖房子必须从建材市场买材料不能自己凭空变出来。常见的 JDK 发行版有两个Oracle JDKOracle 官方版商业使用时要注意授权协议。OpenJDK开源版免费各大云厂商都基于它做发行版如 Eclipse Temurin、Amazon Corretto。对于普通学习我推荐用Eclipse Temurin或Amazon Corretto都是长期支持版本免费开源国内下载速度也还可以。安装 JDK 很简单下载对应平台的安装包一路 Next 安装然后记得记下安装路径。比如 Windows 上可能装在C:\Program Files\Eclipse Adoptium\jdk-17.0.xx。但这里有个历史遗留问题要提醒一下很多教程让你先配JAVA_HOME环境变量再把 bin 目录加到 Path。这套操作在以前是必须的因为在命令行编译运行都要用到javac。但现在用 IDEA 开发IDEA 可以在项目设置里直接指定 JDK 路径不配置环境变量也能正常跑。配置JAVA_HOME更多是为了命令行方便以及给 Tomcat、Maven 等外部工具使用。我的建议是省事起见直接配好一劳永逸。配置方法右键此电脑→ 属性 → 高级系统设置 → 环境变量。新建系统变量JAVA_HOME值为 JDK 的安装根目录然后在Path中添加%JAVA_HOME%\bin。配置完后打开命令行输入java -version验证一下能输出版本号就算成功。3.2 在IDEA里配置JDK打开 IDEA 欢迎界面点击Customize→All settings...进入全局设置。也可以在进项目后按快捷键CtrlAltS打开 Settings。在设置里找到Build, Execution, Deployment → Build Tools → Maven这里的Runner配置项里可以设置JRE选择你本机安装的 JDK。但真正核心的配置在项目级别。当你新建项目时IDEA 会提示选择Project SDK。如果下拉框里没有你想要的 JDK就点Add SDK → JDK然后选择 JDK 的安装根目录。注意是选到 JDK 的根目录不是 bin 目录也不是 jre 目录。选择正确后下面会显示出 JDK 的版本号。配置完成后进入File → Project Structure快捷键CtrlAltShiftS在Project标签页可以看到三个选项SDK项目使用的 JDK 版本比如说17。Language levelJava 语法等级。这里建议和 SDK 版本保持一致这样能使用全部新语法。Project compiler output编译输出目录默认是项目下的out目录不用动。到这里IDEA 就能正常识别 JDK 并编译运行代码了。3.3 全局配置字体、快捷键、重启为了让日常写代码舒服一点有几个全局设置值得花两分钟调一下。首先是字体。默认字体在 Windows 上可能显示比较细或模糊。在Settings → Editor → Font中把字体设置为Consolas或JetBrains Mono字号 14 或 16行间距 1.2 左右。这样代码显示清晰中文注释也能正常显示如微软雅黑。其次是快捷键。如果你以前用 Eclipse可以在Settings → Keymap里把快捷键方案从Default换成Eclipse这样CtrlShiftO就是自动导入包CtrlShiftF是格式化符合老 Eclipse 用户的肌肉记忆。如果你是全新新手用默认方案即可不用折腾。还有个常见问题改了一些本地设置后IDEA 会提示你Restart。别嫌麻烦很多配置确实要重启 IDE 才能生效比如安装插件、切换主题、修改内存参数。如果改了却不重启可能出现找不到插件界面卡在旧状态的情况。说到内存如果你的电脑内存只有 8G 或更少IDEA 可能有点卡。这时可以修改 IDEA 的启动内存。在 IDEA 安装目录的bin文件夹下idea64.exe.vmoptions文件里调整-Xmx参数比如改成-Xmx2048m。注意这文件改的时候最好先备份改错了会导致 IDEA 打不开。如果不懂参数含义尽量只调-Xms和-Xmx。注意新版 IDEA 可以通过Settings → Advanced Settings里直接调整内存图形化界面比改 vmoptions 安全得多推荐用这种方式。4. 第一个Java项目从New Project到Hello World4.1 创建项目在欢迎界面点击New Project后IDEA 的 New Project 向导就出来了。这一步不同版本略有差别但核心逻辑是一样的。第一步选择左侧的New Project注意不要选 Spring Boot 之类的模板。右侧会显示构建系统选项IntelliJ不引入 Maven/Gradle直接纯 Java 项目。适合快速验证代码。Maven引入 Maven 构建适合以后要打 jar 包、引入第三方依赖的项目。GradleAndroid 或需要复杂构建配置时使用。新手入门阶段先选IntelliJ后面再慢慢学 Maven。因为 Maven 需要联网下载依赖网络不稳定时会白等很长时间容易打击信心。第二步选择SDK。也就是前面在 3.2 节配置的 JDK。如果这里显示 No SDK就点Add SDK手动选择 JDK 根目录。第三步点击Next输入项目名称比如HelloWorld。路径默认会放在用户目录下你可以改成自己习惯的工作目录比如D:\Code\HelloWorld。Language level 保持默认模板可以直接用Generate project from template选项创建一个带main方法的命令行程序。如果没有这个选项后面自己写main方法也行不耽误。点击Create后IDEA 会自动创建项目并打开主界面。左侧的Project工具窗口里就能看到src目录、.idea目录这是 IDEA 的项目配置目录以及项目的.iml文件。如果看不到src可能是导入模式问题关掉重新打开或确认目录结构即可。4.2 写代码、运行、调试在src目录上右键 →New → Java Class输入类名Main。然后写一个最简单的主类public class Main { public static void main(String[] args) { System.out.println(Hello, IntelliJ IDEA!); } }写完代码后点击运行按钮。运行按钮在哪IDE 右上角有一个绿色三角形图标或者在代码编辑器里点击右键 →Run Main.main()。如果你编辑了代码但没保存IDEA 会在运行时自动保存这跟某些需要手动 CtrlS 的编辑器不同。运行后会展开一个底部的Run工具窗口里面输出Hello, IntelliJ IDEA!。看到这行输出你的第一个 Java 项目就跑通了。这里推荐一个写代码阶段非常实用的快捷键组合建议现在就练熟psvm Tab快速生成public static void main。sout Tab快速生成System.out.println()。Ctrl P查看方法参数。Ctrl Alt V快速引入变量并赋值。F7/F8/F9单步进入、单步跳过、恢复程序。如果代码出错了IDEA 会在编辑器的右侧和下方用红色波浪线提示错误。把鼠标悬停在红色波浪线上IDEA 会给出错误原因和快速修复建议按AltEnter可以直接选择修复操作。这是 IDEA 比记事本编译 Java 效率高得多的原因之一。4.3 Maven项目的基础玩法纯 Java 项目只能用来练习基础语法。一旦你要引入第三方包比如用commons-lang3、fastjson、数据库驱动就需要 Maven 来管理依赖。在 IDEA 里创建 Maven 项目也不复杂。New Project时在左侧选择Maven右侧设置好 SDK点击 Create 即可。IDEA 会生成一个标准的 Maven 目录结构项目名 ├── pom.xml ├── src │ ├── main │ │ └── java Java源码 │ └── test │ └── java 测试代码依赖管理在pom.xml里配置。例如引入 fastjsondependencies dependency groupIdcom.alibaba/groupId artifactIdfastjson/artifactId version2.0.25/version /dependency /dependencies保存后 IDEA 会自动下载依赖可能需要等待一会儿。下载完成后代码里就能直接import com.alibaba.fastjson.JSON;使用了。如果下载慢建议在 Maven 设置里配置阿里云镜像路径在Settings → Build, Execution, Deployment → Build Tools → Maven → Settings File在settings.xml的mirrors里加入阿里云仓库地址。这一步网上很多现成配置照着贴即可。5. 跑Web程序Community版集成Tomcat的正确姿势5.1 为什么要用Smart Tomcat插件很多新手学到 Servlet、JSP 阶段会遇到一个尴尬问题Community专业版不支持在 Run 配置里直接选择 Tomcat Server。你打开Edit Configurations加号里找半天也没有 Tomcat 的选项。这是 Community 版的正常情况——它不内置应用服务器支持。解决思路主要有两种第一种下载安装 Tomcat手动把编译好的 war 包或 class 文件拷贝到 Tomcat 的 webapps 目录然后启动 Tomcat。这个方式能跑但每次修改代码都要重新编译、拷贝、重启 Tomcat效率很低。第二种安装Smart Tomcat插件。这是 GitHub 上一个开源插件专门用来弥补 Community 版不带 Tomcat 支持的短板。它可以在 IDEA 里直接配置部署目录、URL、端口运行调试时自动把你项目构建产物部署到 Tomcat修改代码后自动热加载。强烈推荐第二种。当然Ultimate旗舰版用户直接用内置的 Tomcat Server 配置就行但 Community 用户用 Smart Tomcat 一样能丝滑开发只是需要多装一个插件而已。5.2 配置Smart Tomcat的详细步骤第一步安装插件。在 IDEA 里打开Settings → Plugins在 Marketplace 搜索框输入Smart Tomcat找到后点 Install。安装完成后会提示重启按要求重启 IDEA。第二步下载 Tomcat。去 Apache Tomcat 官网下载建议选 Tomcat 9 或 Tomcat 10版本不同Java 版要求不同。Tomcat 9 对应 Servlet 4.0Tomcat 10 对应 Servlet 5.0一般学校课程用 Tomcat 8.5 或 9 比较多。下载zip版后解压到一个无中文、无空格的路径比如D:\apache-tomcat-9.0.xx。解压后目录结构里有几个重点conf是配置文件目录webapps是 Web 应用部署目录bin里有启动关闭脚本。记得给bin设置环境变量CATALINA_HOME指向 Tomcat 根目录或者后面在 IDEA 里直接指定路径也行。第三步配置项目。假设你先创建了一个普通的 Web 项目里面写了 Servlet 或 JSP 页面。在 IDEA 顶部工具栏找到运行配置下拉框点击Edit Configurations→ 点左上角加号 → 选择Smart Tomcat类型安装插件后才会出现。配置窗口里需要重点填几个字段Tomcat Server选择你解压的 Tomcat 根目录IDEA 会自动识别conf/server.xml。Context Path应用程序上下文路径比如填/hello访问时就是http://localhost:8080/hello。Deployment Directory部署目录。这里要注意Smart Tomcat 部署的是构建产物目录一般用 Maven 项目时填target目录普通 Java Web 项目填out/artifacts或web。每个项目可能不太一样一般填target就行。Server Port默认 8080看 Tomcat 的server.xml设定。Application server选择你配置好的 Tomcat。配置完成后点运行按钮Smart Tomcat会自动启动 Tomcat并在浏览器中打开你配置的 URL。如果页面显示 Tomcat 默认首页或你自己的 Servlet 输出说明集成成功。注意Smart Tomcat 的部署方式和 Ultimate 原生 Tomcat 集成不一样。它实际上是把构建产物映射到 Tomcat 的运行目录所以你在修改代码时要确保项目执行了buildIDEA 一般会自动编译否则浏览器看到的还是旧代码。6. 版本控制集成SVN和Git的配置细节6.1 SVN集成虽然现在 Git 已经是大势所趋但不少老企业、学校课程和外包项目还在用 SVN。IDEA 对 SVN 的支持比较完善Community版一样能用但需要单独配置。首先你要确认本机安装了 SVN 客户端。Windows 上常见的是安装TortoiseSVN安装时有一个关键勾选在Select Additional Tasks页面记得勾选command line client tools。因为 IDEA 本身不内置 SVN 命令行程序它需要调用外部 SVN 命令。如果不勾选后面 IDEA 会一直报错找不到 svn 可执行文件。打开 IDEA 的Settings → Version Control → Subversion在这里配置相关选项Use command line client勾选并指定svn.exe的路径默认在C:\Program Files\TortoiseSVN\bin\svn.exe。Enable interactive mode建议勾选这样遇到证书、认证弹窗时能正常交互。Clear authentication cache如果你账号密码一直弹可以清一次缓存。配置好后从 SVN 仓库拉取代码File → New → Project from Version Control → Subversion输入仓库地址和账号密码IDEA 会像打开本地项目一样把代码 checkout 到本地。在 IDEA 里对 SVN 的日常操作和 Git 很像修改文件会变色提交用CtrlK更新用CtrlT。右键Subversion菜单里还能看Annotate历史标注直接在代码行上显示最后修改人和版本号这个功能在处理遗留系统时特别好用。6.2 Git集成与Local Changes窗口消失问题Git 集成是 IDEA 的老本行安装完基本不需要配置只要能识别本机git.exe就行。Windows 安装 Git 时默认选项即可IDEA 会自动找到C:\Program Files\Git\bin\git.exe。新版 IDEA2021.2 以后改过一次界面把原来的 Local Changes 放进了同一块面板很多老用户刚升级的时候会一脸懵。原来 Commit 窗口下方还有Local Changes标签现在被合并进了左侧的Commit工具窗口。你打开Alt0或点击左下角Commit按钮会看到一个统一的提交视图所有未提交的改动会出现在那里。如果你发现改动文件没有出现在 Local Changes 列表里大概率是文件没有纳入版本控制或在提交视图中勾选了Changes筛选选项。还有一个常见的坑新建项目后.gitignore文件没配置好导致target、.idea这些不该进版本库的目录全部被 Git 跟踪。提交时一堆垃圾文件看着就头疼。建议在创建项目时或者第一次提交前先加一份.gitignore.idea/ target/ *.iml *.class .DS_Store另外如果你从命令行git clone后再用 IDEA 打开IDEA 会提示信任项目并自动识别远程仓库配置。只要右下角出现Git: master这样的分支信息就说明 Git 集成已经正常工作。7. 遇到这些问题你不孤单常见问题实录7.1 JSP没有高亮和颜色配置很多同学学 JSP 时会发现在Settings → Editor → Color Scheme里找不到 JSP 对应的单独配色项。于是问IDEA 中 color scheme 没有 JSP 怎么办。其实这是正常的。IDEA 对 JSP 的语法高亮依赖的并不是一个叫 JSP 的独立配色方案而是把它视为 Java 和 HTML 的混合文件。JSP 里的% %部分走的是 Java 配色html等标签走的是 HTML 配色。所以你只要调整了Color Scheme → Java和HTML的配色JSP 里对应的部分就会跟着变。如果发现 JSP 文件完全没有高亮可能是文件类型映射出了问题。检查Settings → Editor → File Types确认*.jsp是否被识别为JavaServer Pages。如果没有手动加一行映射即可。另外小型项目里 JSP 的el表达式和 JSTL 标签可能不提示这是正常的代码分析范围问题不用纠结。7.2 插件装不上/无法联网热词里有人问IntelliJ IDEA 2025.2.6.3 插件安装感觉没法联网。这个问题大概率跟代理、网络环境有关。IDEA 默认从 JetBrains 官方插件市场下载插件国内网络访问时快时慢有时会直接超时。遇到这种问题可以先在Settings → Appearance Behavior → System Settings → HTTP Proxy里检查是否有代理配置。如果公司或校园网需要代理选Manual proxy configuration填上代理地址如果以前配置过代理但现在已经不用选No proxy。还有一个更频繁的原因你的 IDEA 版本太旧官方插件市场已经不对旧版本展示兼容插件。这时插件列表可能能打开但搜索不到想要的插件。可以尝试在插件市场搜索框上面点击官方提示切换到旧版兼容仓库。但根治办法还是升级 IDEA 到较新版本。此外有些国产插件和官方插件没有上架插件市场需要下载.zip手动安装。在Settings → Plugins → 设置齿轮 → Install Plugin from Disk选择本地 zip 包即可。7.3 win7老机器能不能跑现在网上还能看到不少人问IntelliJ IDEA win7 能不能安装。说实话新版本的 JetBrains IDE 对 Windows 7 支持越来越弱官方已经逐步放弃 Win7 支持。如果你还在用 Win7建议找 2020.x 或 2021.x 的旧版本安装包这些版本对 Win7 还友好一些。但旧版本也意味着老插件、老 JDK 支持不能用新 JDK 的语法。如果你确实受限于 Win7我建议至少升到 Win10。为了开发工具去折腾老系统兼容时间和精力的成本太高了。7.4 关于激活码和破解的真心话写到这里我想专门聊聊IntelliJ IDEA 破解激活码这些词。我在搜索热词里看到很多人在找这个东西这里我只说一个观点Community 版是完全免费、开源的根本不需要激活码。如果你确实要用到 Ultimate 版的企业功能官方有 30 天免费试用学生和教师也可以通过学校邮箱申请免费授权。如果你工作所在的公司买了正版授权直接找公司 IT 要激活方式就行。从我个人的实战经验来看绝大多数学习场景用免费版已经足够了。与其花时间研究破解多写几行代码、多跑通几个例子进步的效率高得多。最后分享一个我实际工作中的体会工具只是起点顺手才是关键。安装一个 IDE 不是目的真正重要的是你愿意在一个环境里持续写代码。Community 版免费、稳定、长期维护是入门的理想选择。等你哪天真的遇到非 Ultimate 不可的需求官方订阅附带的授权方式也能让你用得更安心。这篇教程我用的是 2023~2025 年间的版本截图界面不同版本菜单翻译可能略有差异但核心路径基本一致。带着这份文档从头到尾走一遍从下载到跑通第一个 Java 项目再到部署 Servlet整个过程正常情况下半天内可以完成。遇到问题别慌多看 IDEA 自己报的提示信息再对症搜索思路就会越来越清楚。