上周帮同事的新机器配环境发现不少人对 IntelliJ IDEA 2023 下载和安装的印象还停留在“找个压缩包解压就能用”结果一路踩坑装完才发现是社区版缺应用服务器集成JDK 版本和项目对不上第一次打开索引跑了半小时控制台中文全是问号。这篇就把 Intellij IDEA 2023 下载、安装教程从头到尾走一遍全部是我在 Windows 11、macOS 和 Ubuntu 上亲测可用的步骤包含 JDK 17 的路径规划、Maven 与 Git 的集成、首次启动后必做的几项设置以及最花时间的排错环节。刚入行的 Java 新人、从 Eclipse 或 VS Code 迁移过来的朋友、需要给团队统一开发环境的老手都能直接抄作业。我会尽量把每个选项“为什么这么点”讲明白而不是只给一串下一步。1. 版本选择先想清楚你要社区版还是终极版1.1 两个版本的真实差别别装完才发现不够用IntelliJ IDEA 2023 分两条线社区版Community Edition和终极版Ultimate。下载页面上两个按钮挨在一起很多人手快点完装好才发现少了半个功能。社区版开源免费覆盖 Java、Kotlin、Groovy 语言本身以及 Maven、Gradle、Git、JUnit、调试器、反编译器这些纯 JVM 开发要用的东西日常写算法、写工具类、写 Spring Boot 单体项目完全够。终极版是商业授权多出来的部分主要在企业级框架和应用服务器Spring / Spring Boot 的全套配置提示与运行面板、Jakarta EE、Tomcat / Undertow / Jetty 等应用服务器的图形化集成、数据库工具窗口、内置 HTTP Client、JavaScript 与 TypeScript 支持、远程开发、Profiler 等。说白了终极版把“框架 服务器 数据库 前端”这一整套粘在了同一个窗口里省的是来回切工具的时间。我的判断标准很直接学生、转行自学的、只写纯 Java 或写点小工具的人先用社区版公司项目重度依赖 Spring 全家桶、又要频繁连数据库调 SQL、还要跑本地 Tomcat 的终极版体验差距会非常明显。这里有句必须提前说的话——社区版默认没有 Tomcat 运行配置不代表不能用装一个 Smart Tomcat 插件照样跑得起来具体步骤我在第 6 章会给。能力项社区版终极版Java / Kotlin / Groovy支持支持Maven / Gradle支持支持Git 版本控制支持支持Spring / Spring Boot 深度支持基础语法高亮完整配置、Bean 导航、运行面板Tomcat / Jetty 集成需第三方插件内置数据库工具窗口无内置JavaScript / TypeScript无内置授权方式开源免费商业授权官方提供试用与若干免费授权渠道提示网上流传的各种“试用期重置”“非常规激活手段”一律不要碰。企业环境里这类操作可能带来审计风险和不明来源文件的安全隐患正规途径包括官方试用期、面向学生与教师的免费教育授权、面向开源项目的免费授权以及永久免费的社区版。选对渠道比省那点事重要得多。1.2 2023 各小版本怎么挑以及硬件底线2023 这一整年发布了 2023.1、2023.2、2023.3 三个大版本每个大版本下面还有若干补丁版比如 2023.1.x、2023.2.x、2023.3.x。选择逻辑就一句话大版本选离你最近的那个补丁版选数字最大的那个。原因是 JetBrains 的补丁版基本只修 bug 不加功能越靠后的补丁越稳。我在 Windows 11 上实测 2023.2.5 和 2023.3.2 这两个补丁版最省心索引速度、插件兼容性都过得去。如果你所在团队已经有统一版本那就跟着团队走别自己上新。原因很现实不同小版本的.idea目录格式、代码风格配置文件codeStyles偶尔会有细微差异混用之后 Git 里会冒出一堆莫名其妙的变更行提交记录看着头疼。硬件方面我给几条实测出来的线内存 8GB 能启动、能写代码但只要你同时开着浏览器和数据库客户端切窗口就会一顿一顿的16GB 是舒适线能稳稳跑起 IDEA 加两三个服务32GB 可以考虑开多模块大工程加本地容器。硬盘必须是固态机械盘上索引一个中型项目十几分钟起步体验是断崖式下降。CPU 反而不是瓶颈编译吃多核但你写代码时的卡顿更多来自内存和磁盘。能用云端同步就清楚一件事IDEA 的**索引Indexing**是它快的根本也是它慢的根本。它会把项目里所有类、方法、引用关系建成本地索引之后你按Ctrl 鼠标左键能秒跳定义全靠这份索引。所以第一次打开一个大项目时硬盘灯狂闪、风扇狂转属于正常现象不是软件坏了。理解这一点后面第 7 章的排错你会轻松很多。2. 下载环节认准官网下载与校验都要走对2.1 官网下载路径和几个容易点错的选项下载只有一个原则只从官网下。搜索引擎里搜“intellij idea 下载”排在前面的推广位经常是二次打包的站那个安装包里塞了什么你没法验证。正确做法是在地址栏直接输入官网域名进入产品页找 Download 按钮。进去之后你会看到三个关键选择版本Community社区版或 Ultimate终极版。上一步已经定好了。操作系统Windows、macOS区分 Intel 芯片和 Apple 芯片、Linux。macOS 这两个包别下错M 系列芯片选 Apple Silicon老款 Intel 机器选 Intel下错了能装但性能会打折。安装包格式Windows 给的是.exemacOS 是.dmgLinux 通常给.tar.gz另外还提供一个免安装的.tar.gz压缩包给所有平台用。这里有个小细节值得说官网页面会根据你的浏览器 UA 自动判断系统有时候你帮同事下 Linux 版页面默认还停在 Windows 上自己手动切一下。另外同一个页面往下拉通常有“Previous versions”或版本历史入口需要老版本比如团队锁定 2023.1.5就从那里进别去第三方站找历史版本。2.2 校验安装包以及下载慢的时候怎么办下载完成后强烈建议做一次完整性校验。原因很实在安装包动辄七八百兆到一吉多网络抖动导致的截断、公司代理层面的缓存污染都可能让文件“看着能装、装到一半报错”。官网在下载按钮附近通常提供 SHA-256 校验值校验命令很简单# macOS / Linux shasum -a 256 ideaIC-2023.3.2.tar.gz # 或者 sha256sum ideaIC-2023.3.2.tar.gz # Windows PowerShell Get-FileHash .\ideaIC-2023.3.2.exe -Algorithm SHA256把输出和官网给的哈希值逐位比对一致就放心装不一致就重下别抱侥幸心理。至于国内下载速度不用想歪招。几个无害且有效的办法一是选非高峰期下早上七八点或者深夜速度通常明显好过下午二是用带多线程和断点续传能力的下载工具把单连接换成多连接三是公司网络如果有限速策略问一下运维有没有内部软件源很多中大型公司内部会放常用的开发工具镜像。这三招下来一般都能把速度拉到可接受的范围。注意不要从任何网盘分享、论坛附件、打包合集里取安装包。这类文件的来源无法追溯且 JetBrains 官方对安装包的签名校验很严格一旦被人二次打包出问题的概率远大于你省下的那几分钟。3. 安装实操三大平台逐项拆解3.1 Windows 安装向导每个勾选项的作用Windows 上双击.exe之后向导会问你几件事逐条说安装路径。默认在C:\Program Files\JetBrains\...。如果你的系统盘是小容量 SSD建议装到非系统盘比如D:\DevTools\JetBrains\因为除了程序本体后面缓存、索引、插件还会往用户目录写好几 GB提前把空间规划好能省事。路径里不要有中文和空格这是老规矩能避开不少工具链的奇怪问题。安装选项这几项Create Desktop Shortcut创建桌面快捷方式建议勾。后面还要选 64-bit launcher现在的机器基本都是 64 位。Update PATH Variable把 IDEA 的命令行启动器加到 PATH建议勾。这样你在终端里敲idea .就能用当前目录打开工程非常顺手。Update Context Menu右键菜单加“Open Folder as Project”建议勾。拿到一个陌生项目目录时右键直接打开省去每次手动选路径。Create Associations把.java、.kt、.gradle这些文件关联到 IDEA。这一项要慎重如果你机器上还有 Eclipse 或者别的编辑器关联过去之后双击文件默认就用 IDEA 打开了可能不是你想要的。我一般只勾.java和.kt。Download and Install JBR下载并安装 JetBrains Runtime。建议勾这是 IDEA 自己跑起来用的运行时环境跟你的项目 JDK 是两码事让它一并装好能省去后面单独配。点完 Install进度条走完先不要急着点“Run IntelliJ IDEA”。如果这是全新机器先把 JDK 准备好再启动这样第一次进欢迎界面时能一次性把 SDK 配好少一次来回。JDK 的下载和路径规划我在第 4 章讲。3.2 macOS 与 Linux 的安装方式macOS 最简单打开.dmg把 IDEA 图标拖进 Applications 文件夹完事。首次启动时系统会拦一下去“系统设置 → 隐私与安全性”里点“仍要打开”即可。喜欢用包管理器的也可以走 Homebrew# 社区版 brew install --cask intellij-idea-ce # 终极版 brew install --cask intellij-ideaLinux 分两种玩法。有桌面环境的发行版很多直接在应用商店里能搜到但更通用、更可控的是手动解压# 解压到 /opt 下这是 Linux 存放第三方软件的习惯位置 sudo tar -zxvf ideaIC-2023.3.2.tar.gz -C /opt/ # 重命名一下方便以后升级时切换 sudo mv /opt/idea-IC-233.13135.103 /opt/idea # 启动脚本在 bin 目录里 /opt/idea/bin/idea.sh第一次启动后在菜单里选Tools → Create Desktop Entry它就会自动生成.desktop文件之后在应用列表里就能搜到了不用每次敲脚本。如果你的 Ubuntu 是 18.04 这类老版本注意它自带的 glibc 版本可能偏低如果启动报库依赖错误优先考虑升级系统或者用更新的发行版别硬扛。实操心得手动解压这种方式的最大好处是升级无痛。新版本来了解压到另一个目录改一下/opt/idea这个软链指向配置和插件目录是独立的跟着用户主目录走。出问题把软链改回去就回滚了比重新跑安装向导快得多。4. JDK 与项目环境配置这一步决定后面顺不顺4.1 JDK 17 的下载与路径规划2023 这个时间点JDK 17 是主流选择它是长期支持版本LTSSpring Boot 3.x 也要求 Java 17 起步。更老的 8 和 11 依然有大量存量项目在用所以我的建议是机器上同时准备 JDK 8、11、17 三个版本按项目切换。安装方式按平台来Windows 上用.msi或.exe安装包macOS 用.dmg或 HomebrewLinux 用.tar.gz解压。不管哪种方式路径规划的原则是统一的D:\DevTools\JDK\jdk-8\ D:\DevTools\JDK\jdk-11\ D:\DevTools\JDK\jdk-17\每个版本一个独立目录目录名里带上版本号。别用jdk这种没版本信息的名字半年后你自己都想不起来里面是哪个版本。环境变量JAVA_HOME指向当前主用版本需要切换时改一下就行。验证安装成功的命令java -version javac -version echo $JAVA_HOME # Windows 上用 echo %JAVA_HOME%两个版本号输出一致且指向你期望的目录就算成了。这里有个常见坑Windows 上装完新 JDKjava -version还是老的多半是 PATH 里旧版本排在前面或者系统里存在C:\Windows\System32\java.exe这个“影子文件”有些软件会往那儿塞把它删掉或者调整 PATH 顺序即可。4.2 在 IDEA 里把 JDK 接上三个层级别搞混IDEA 里的 JDK 配置分三层很多人卡住就是因为把这三层搅在一起了第一层平台级 SDKPlatform Settings → SDKs。这是告诉 IDEA “我机器上有哪些 JDK 可以用”。点号选Add JDK然后把路径指到你解压出来的 JDK 根目录注意是根目录不是bin目录也不是jre目录指错了会提示“The selected directory is not a valid home for JDK”。第二层项目级 SDKProject Structure → Project。这是告诉 IDEA “当前这个项目用哪个 JDK 编译”。Project SDK 选一个Project language level 也要跟着选对比如 JDK 17 对应 language level 17。language level 低于 JDK 版本时一些新语法比如switch表达式、record会报错明明 JDK 装对了却编译不过八成是这里没跟上。第三层模块级 SDKProject Structure → Modules。多模块项目里单个模块可以覆盖项目级的设置。比如主工程用 17但某个老模块必须用 8就在这里单独改。三层的关系简单类比平台级是“书架上有哪些书”项目级是“这次读哪本”模块级是“某一章要参考别的书”。把这三层理顺后面换 JDK、加模块都不会乱。4.3 顺手把 Maven 和 Git 接上JDK 配好只是能编译真正干活还要 Maven 和 Git。Maven 的配置位置在Settings → Build, Execution, Deployment → Build Tools → Maven。三样东西要改Maven home path用 IDEA 自带的 Bundled 版本最省事也可以指向自己解压的 Maven。User settings file指向你自己的settings.xml。这个文件里通常配了两样关键的本地仓库位置以及远程仓库镜像。Local repository本地仓库缓存目录。默认在用户主目录的.m2/repository时间长了能涨到几十 GB把它挪到空间大的盘上很有必要。国内拉依赖慢是常态在settings.xml的mirrors里配一个公共镜像能明显提速这是社区里非常通行的做法mirror idpublic-mirror/id mirrorOfcentral/mirrorOf namePublic Maven Mirror/name urlhttps://maven.aliyun.com/repository/public/url /mirrorGit 的配置位置在Settings → Version Control → Git把Path to Git executable指向你安装的git.exeWindows或/usr/bin/gitmacOS/Linux。点一下旁边的 Test弹出 Git 版本号就说明接上了。如果你的机器上还没装 Git官网下载对应平台的安装包一路默认下一步即可安装完成后记得验证git --version git config --global user.name 你的名字 git config --global user.email 你的邮箱那两行config别漏否则第一次提交时 IDEA 会反复弹窗问你要身份信息提交记录里的作者名也会显示成机器名看着很不专业。5. 首次启动后七项必做设置5.1 关掉匿名统计、调内存、统一编码关匿名统计。首次启动时欢迎界面会问你要不要发送使用数据那个勾选框很多人是随手点的后来想关又找不到。位置在Settings → Appearance Behavior → System Settings → Data Sharing把里面的勾全部取消即可。同理Settings → Advanced Settings里还有几项后台统计相关的开关介意的话一并关掉。调内存。这是提升流畅度最立竿见影的一项。菜单Help → Change Memory Settings改的是堆上限。给几个实测参考值机器内存建议堆上限说明8 GB1024–1536 MB再高会挤压系统和其他软件16 GB2048–3072 MB舒适区多数中型项目够用32 GB4096–6144 MB大型多模块项目、同时开多个工程这个值不是越大越好。设得比物理内存还高反而会导致系统频繁换页卡得更厉害。改完重启 IDEA 生效。深度定制的话可以直接编辑idea.vmoptions文件写法是-Xms512m -Xmx3072m -XX:ReservedCodeCacheSize512m-Xms是初始堆-Xmx是上限把这两个设成一样能减少运行时扩容带来的抖动。统一编码。Settings → Editor → File Encodings把Global Encoding、Project Encoding、以及Default encoding for properties files三个都设成UTF-8最后那个Transparent native-to-ascii conversion建议勾上否则.properties里的中文会变成\uXXXX形式。这一步做完能省掉后面一大堆“控制台中文乱码”“读文件乱码”的问题。5.2 插件市场连不上时的替代路径公司网络做限制是很常见的事插件市场偶尔会转圈圈或者报连接失败。遇到这种情况别死磕有两条稳妥的替代路径第一条离线安装。在能正常访问网络的机器上打开插件页面下载对应 IDEA 版本的插件包.zip格式注意版本号要和你 IDEA 的大版本对得上2023.3 的插件装到 2023.1 上大概率报不兼容然后在Settings → Plugins里点齿轮图标选Install Plugin from Disk选中那个 zip 包安装重启生效。第二条让运维开白名单。插件市场走的是固定域名把域名报给运维加进白名单一次配置长期有效。这比每次找离线包省事得多。我建议新手阶段先只装三四个真正用得上的插件比如Lombok如果你项目里用了 Lombok 注解不装这个插件代码会满屏飘红。Rainbow Brackets多层嵌套的括号用不同颜色区分看复杂表达式时眼睛舒服很多。Translation划词翻译看英文文档和报错信息时很实用。SonarLint本地静态代码检查提交前能自己发现一批低级问题。插件这东西宁缺毋滥。装太多会拖慢启动速度、增加内存占用有些插件之间还会互相干扰。5.3 界面与操作习惯的几个调整字体和行高。Settings → Editor → Font代码字体建议选等宽的编程字体字号 14 到 16 之间看屏幕大小定行高设成 1.2 到 1.3 倍长时间看代码眼睛不容易累。自动导包。Settings → Editor → General → Auto Import把Add unambiguous imports on the fly和Optimize imports on the fly都勾上。这样你敲类名的时候 IDEA 自动补 import删代码时自动清理没用的 import非常省心。显示行号和方法分隔线。Settings → Editor → General → Appearance里勾Show line numbers和Show method separators。方法分隔线在长文件里能明显提高定位效率。快捷键方案。Settings → Keymap如果你从 Eclipse 或者 VS Code 过来可以直接在下拉框里选对应的方案肌肉记忆能直接复用不用重新背一套。6. 社区版跑 Tomcat 的完整方案6.1 为什么社区版没有 Tomcat 入口很多人装完社区版建好 Web 项目在Run/Debug Configurations里翻遍了也找不到 Tomcat 那一项以为自己装错了。这不是 bug是版本差异应用服务器集成属于终极版的功能范围。社区版的定位就是“纯 JVM 代码开发”Web 容器这块交给插件生态。替代方案有两个Smart Tomcat 插件或者干脆用 Maven 的 Tomcat 插件从命令行跑。前者图形化、接近终极版体验后者更轻量适合脚本化和 CI 环境。6.2 Smart Tomcat 插件的安装与配置在Settings → Plugins → Marketplace里搜Smart Tomcat安装后重启。然后顶部运行配置下拉框点Edit Configurations点左上角选Smart Tomcat。Name随便起比如local-tomcat。Tomcat Server一栏点Configuration选中你本地解压的 Tomcat 根目录。Deployment里Deploy directory or WAR file located under选你的 Web 应用目录如果是 Maven 项目通常指向src/main/webappContext path填/或者你的应用名。Server Port默认 8080如果被占用就改。VM options里按需加参数比如内存和编码-Dfile.encodingUTF-8 -Xmx512m。配置好点运行控制台出现 Tomcat 启动日志浏览器访问http://localhost:8080能看到页面就成了。注意Tomcat 的版本要和你的 Servlet 规范对得上。Tomcat 9 对应 Servlet 4.0javax.servlet包Tomcat 10 及以上换成了jakarta.servlet包包名变了。用 Spring Boot 2.x 配 Tomcat 10启动会直接报ClassNotFoundException很多人第一反应是依赖冲突其实是版本对不上。选之前先看一眼项目里 import 的是哪个包名一秒就能判断。7. 常见问题与排查速查7.1 启动慢、索引卡住、CPU 飙高首次打开项目索引跑很久这是正常的索引本身就要遍历所有源码和依赖。判断是不是“真卡住”的方法看右下角进度条的文字如果一直在变比如从Scanning files变成Indexing说明在正常干活如果十分钟纹丝不动那才可能有问题。加速索引的几招把不必要的目录标记为 Excluded右键目录 →Mark Directory as → Excluded比如target、build、node_modules、日志目录这些内容对代码索引没价值排除掉能省大量时间确认-Xmx设得够大把项目放在 SSD 上。CPU 长期占满先看是什么在跑。Help → Diagnostic Tools → Activity Monitor能看到各线程的占用情况。常见元凶是某个插件在做后台分析或者项目开了自动编译加大量文件监听。排查顺序禁用最近新装的插件试试关掉Build, Execution, Deployment → Compiler里的自动构建看曲线有没有下来。启动画面卡在 Loading Project八成的锅是缓存坏了。处理方式File → Invalidate Caches / Restart选Invalidate and Restart。这一步会清掉索引和缓存下次打开重新建能解决绝大多数“莫名其妙不对”的问题代价是重建索引要等一会儿。7.2 编译报错、中文乱码、端口占用中文乱码分两种场景。控制台乱码先查Settings → Editor → File Encodings是不是全 UTF-8再查运行配置里有没有加-Dfile.encodingUTF-8。Windows 上还有一种情况控制台默认代码页不是 UTF-8需要在运行配置的 VM options 里明确指定编码或者把系统区域设置的 UTF-8 支持打开。编译报“cannot find symbol”但类明明存在优先检查三件事依赖有没有下载完整去 Maven 面板点刷新看 External Libraries 里有没有那个 jarSDK 和 language level 对不对对不上会识别不了新语法是不是项目里有重复类名冲突。端口被占用报错信息里会写Address already in use: bind。排查命令# Windows netstat -ano | findstr :8080 taskkill /PID 进程号 /F # macOS / Linux lsof -i :8080 kill -9 进程号或者干脆在运行配置里把端口改成 8081、8082冲突立刻消失。7.3 问题速查表现象大概率原因处理方式启动后一直索引首次索引或缓存异常等待若超久则 Invalidate Caches 重建代码满屏飘红但运行正常插件缺失或索引未完成补装 Lombok 等插件等待索引结束找不到 Tomcat 运行选项用的是社区版装 Smart Tomcat 插件控制台中文问号编码设置不统一File Encodings 全设 UTF-8运行加-Dfile.encodingUTF-8启动报 Servlet 类找不到Tomcat 版本与包名不匹配Tomcat 9 配javax.*Tomcat 10 配jakarta.*插件市场连不上网络策略限制离线安装插件或让运维加白名单试用期结束无法继续开发授权到期走官方正规渠道社区版、教育授权、开源授权或购买这张表建议存下来遇到问题先扫一眼能省不少搜索时间。前面提到过的那句老话在这里再强调一遍遇到授权相关问题一律走官方渠道解决。为了一时方便去找来路不明的工具或者补丁最后要承担的风险和成本通常远超授权本身。8. 我的几点实际体会踩过这么多次安装配置的坑最想分享的是三条经验。第一条是关于版本的别追最新追最稳。新大版本刚出来那两周插件兼容性问题会集中爆发尤其是你依赖的几个小众插件还没跟上。我的习惯是新版本发布后等两三个补丁版再升。IDEA 升级前有个好习惯值得养成——先导出设置File → Manage IDE Settings → Export Settings出问题一键导回来比手动一项项恢复快得多。第二条是关于环境的把 JDK、Maven、Git 这三样先装好再装 IDEA。顺序反了的话你会在首次启动引导里被反复打断配一半退出、重新进来又得从头找路径。而且提前规划好目录结构所有开发工具统一放一个根目录每个版本一个子目录半年后你自己回头看会感谢当时的自己。第三条是关于心态的第一次打开大项目卡顿、索引慢、风扇响这些都不代表你装错了。我见过太多新人因为这个把 IDEA 卸了重装三四遍其实什么都没坏。判断标准不是“卡不卡”而是“有没有报错”。没有红色报错、进度条在动就让它跑泡杯茶回来通常就好了。最后一个实用小技巧收尾如果你经常需要在多个项目之间切换花十分钟研究一下File → Open Recent和File → Recent Projects的区别再给自己的常用项目起个有意义的名字而不是让 IDEA 默认用文件夹名项目一多的时候这个习惯能帮你每天省下好几次“我到底打开的是哪个工程”的犹豫。