很多刚开始学 Java 的朋友都会在第一步——装开发环境——这里卡住。明明照着网上的教程一步一步点结果到了写 HelloWorld 的时候要么项目建不起来要么代码标红要么控制台中文乱码。我帮人远程调环境的时候十次里有八次问题都出在 IDEA 安装和配置的细节上。这篇文章我把整个流程从头到尾捋一遍包括工具选型、JDK 环境、安装步骤、新建项目、跑通第一个程序以及我实际踩过的坑尽量让你看完之后一次搞定。这篇内容面向的人群很明确刚接触 Java 的初学者、准备从 Eclipse 转到 IDEA 的开发、以及在老电脑上折腾开发环境的学生党。文章里所有的操作都基于当前稳定版 IntelliJ IDEA 的界面来写菜单名称我尽量给出中英文对照方便不同版本之间对应。如果你手头的版本界面稍有不同也不用慌核心的配置项位置基本没变。1. 为什么是 IntelliJ IDEA以及搭建思路1.1 选 IDEA 还是 Eclipse先说一个很多人纠结过的问题我到底该用 Eclipse 还是 IntelliJ IDEA我早年写 JavaWeb 的时候Eclipse 是绝对的主流那时候学校教材、培训机构、网上的教程清一色全是 Eclipse。但最近这几年情况完全反过来了。我在的多个技术社群里问问题的新人基本清一色用 IDEA老项目组的同事也陆续换了过来。IDEA 在代码提示、重构、插件生态、内置工具链上的体验确实比 Eclipse 领先一个身位。如果你不是为了适配某个老项目的既有环境直接学 IDEA 是更省时间的选择。IDEA 有两个版本Ultimate旗舰版和 Community社区版。Ultimate 收费支持 Web、Spring、数据库工具等高级功能Community 免费、开源支持 Java、Kotlin、Gradle、Maven 这些核心开发场景。这里我给一个非常明确的建议学习阶段直接用 Community 版完全够用。我见过不少新人上来就去找破解版其实完全没必要。社区版不仅能跑 JavaSE 项目也能写 Maven 工程、JavaWeb 里的 Servlet、JSP 等基础内容只是对 SpringBoot 这类企业级框架的原生支持较弱。等你工作之后公司自然会提供正版授权。注意市面上流传的“激活码”“破解补丁”一则违反软件许可协议二则很容易捆绑恶意代码。JetBrains 对学生和开源项目作者都有免费授权政策真需要旗舰版功能去官网申请正版授权比什么都稳。1.2 搭建一个可用环境需要准备哪些东西一个能正常开发 Java 程序的环境至少包含三部分JDK、IDEA、以及构建工具Maven/Gradle。很多人以为装好 IDEA 就万事大吉其实 IDEA 只是个“编辑器壳子”真正把 Java 源码编译成字节码的是 JDK 里的 javac 命令。所以标准流程一定是先装 JDK再装 IDEA最后在 IDEA 里指定 JDK 路径。构建工具Maven 是 Java 项目最常用的负责管理第三方依赖的 jar 包比如你项目里要用 MySQL 驱动、FastJSON总不可能手动去网上下载 jar 再复制到 lib 目录Maven 能自动帮你完成这件事。IDEA 社区版内置了 Maven 和 Gradle 支持不需要单独安装但配置文件建议按我后面给出的方式优化一下不然国内网络环境下载依赖时会让你怀疑人生。1.3 整体流程梳理我按实际操作的顺序把流程拆成了五步整篇文章也按这个顺序来安装并配置 JDK下载并安装 IntelliJ IDEA首次启动的基础配置新建项目并跑通 HelloWorld常用配置与常见问题排查这样做的好处是每完成一步都能立刻验证上一步是否成功不会出现“装到最后报错却不知道错在哪一步”的情况。2. JDK 的安装与环境变量配置2.1 JDK 版本到底怎么选很多新手会卡在版本选择上JDK 8 还是 JDK 17JDK 21 是不是最新的新出的 JDK 25 要不要用先说结论分三种情况如果你是在校学生跟着学校教材学教材大概率基于 JDK 8 写的那你就装 JDK 8如果教材比较新写了 JDK 17 以上那就装对应的版本跟着教材走最省心。如果你是自学想兼顾现在的主流企业和未来趋势装 JDK 17。JDK 17 是长期支持版本LTS稳定性好Spring Boot 3 也要求 JDK 17 起步大部分公司已经切换到 17 或 21。如果你进公司了看公司项目用的什么版本直接装对应版本不要自己随意升级。JDK 小版本内的升级没问题大版本间升迁牵扯到项目依赖兼容性别擅自决定。这里额外提醒一句IDEA 从 2021 年的版本开始官方就建议基于 JDK 11 以上运行新版 IDEA 自己内置了 JetBrains Runtime基于 JDK 17/21所以 IDEA 本身不需要依赖你系统里装的 JDK 也能启动。但你的项目仍然需要独立的 JDK所以系统里的 JDK 该装还是要装。2.2 Windows 下的 JDK 安装与环境变量去 Oracle 官网或者 Adoptium 官网也叫 Eclipse Temurin下载 JDK 17 的 Windows 安装包。Oracle 的安装程序会顺带帮你把环境变量配好Adoptium 的 MSI 安装包也有类似选项勾选“Set JAVA_HOME variable”和“Add to PATH”就行。如果安装的时候没勾或者你下载的是解压版zip 包那就手动配置右键“此电脑” → 属性 → 高级系统设置 → 环境变量新建系统变量 JAVA_HOME变量值填 JDK 安装目录比如C:\Program Files\Java\jdk-17。然后在 Path 里新增一行%JAVA_HOME%\bin。配置完成后打开命令行窗口输入java -version javac -version两个命令都能正常输出版本号说明 JDK 就绪了。如果提示“不是内部或外部命令”说明 Path 里 JAVA_HOME 没有生效重新检查变量名是不是写错、路径是不是指到了 JDK 目录要看目录里有没有 bin 文件夹。2.3 macOS 下的 JDK 安装macOS 上装 JDK 最简单的方式是用 Homebrewbrew install openjdk17但 Homebrew 安装的 JDK 默认不会被系统识别为 JDK需要手动做符号链接官方会给提示。不想折腾的话直接下载 Azul Zulu 的 macOS 安装包.pkg 或者 .dmg双击安装一路下一步装完直接生效。验证方式和 Windows 一样终端里输入java -version javac -version2.4 为什么我坚持让你先验证再往下走这一步我单独拿出来说是因为我见过太多人跳过验证环节装好 IDEA 之后新建项目IDE 里报了一堆“Cannot find JDK”然后又回头找是不是 IDEA 装坏了实际上问题出在 JDK 没配好。先跑通java -version再继续装 IDEA能把定位范围缩小一半。3. IntelliJ IDEA 的下载与安装3.1 下载渠道与版本选择IDEA 的官网地址是 jetbrains.com/idea进去之后页面会自动识别你的操作系统。页面上会有两个下载入口一个是 Ultimate一个是 Community注意看清楚别下错了。社区版下载页面往下拉就能看到“Download”按钮安装包体积在 1GB 左右尽量用官网下载不要图省事去第三方网站下载防止被捆绑安装。如果你的电脑是 Windows 10 或更高版本选 x64 或 ARM64 版本要根据 CPU 架构来绝大多数 Intel/AMD 电脑选 x64。Windows 用户下载下来的安装包通常是一个 .exe 文件macOS 用户则是 .dmg 文件。这里提一个历史坑如果你还在用 Windows 7新版 IDEA 已经不再支持了这个系统需要装旧版本比如 2020.3 或 2021.1 版本。这个咱们后面常见问题里细说。3.2 Windows 安装过程详解双击安装包进入安装向导。第一步选择安装路径建议不要装在 C 盘默认目录之外也行但路径中不要出现中文和空格所以不要装到“D:\软件\IDEA”这种带中文的路径下防止某些老插件识别路径出问题。第二步是安装选项。这里有几个勾选项“Create Desktop Shortcut” 建议勾上方便双击启动“Update PATH variable” 和 “Open Folder as Project” 建议保持默认“Download JBR” 这个选项比较关键默认会下载 JetBrains Runtime相当于给 IDEA 自带的运行环境建议保留能避免一些奇怪的启动问题“Add bin folder to the PATH” 如果不想在命令行里用 idea 命令可以不勾安装完成后勾选“Run IntelliJ IDEA” 启动就进入首次启动配置。3.3 macOS 安装与首次启动macOS 下双击 .dmg 文件把 IntelliJ IDEA 图标拖进 Applications 文件夹即可。首次打开时因为是从网上下载的应用系统可能会提示“无法打开因为无法验证开发者”这时候到“系统设置 → 隐私与安全性”里点击“仍要打开”就行了。首次启动会有一个“Import Settings”的选项如果你之前装过旧版本 IDEA想沿用原有配置就选导入全新安装直接选“Do not import settings”。3.4 首次启动的配置项直接给你推荐方案首次启动会进入一个自定义界面有几个关键项主题配色Darcula深色和 IntelliJ Light浅色这个纯看个人习惯后期随时能改创建桌面入口和启动脚本按默认来插件安装首次启动界面会推荐一些插件先不要装一堆保持默认等基础流程走通了再按需加进主界面后先别急着新建项目先确认一件事File → SettingsmacOS 是 IntelliJ IDEA → Preferences里搜索 “JDK”确认系统能自动识别到 JDK。如果列表空着点击 “Add JDK”手动选择 JDK 安装目录Windows 一般是C:\Program Files\Java\jdk-17macOS 则是/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home。4. 用 IDEA 新建项目跑通第一个程序4.1 新建项目时的几个选择到底该怎么填主界面点击 “New Project” 后你会看到几个关键选项Project Name项目名建议用全英文Project Location项目保存路径同理不要有中文Language选 JavaBuild System这里有 IntelliJ、Maven、Gradle 三个选项。初学者做简单练习可以直接选 IntelliJ它不需要额外配置文件后面做真正的项目时选 MavenJDK选择你刚配置好的 JDK 版本有些版本还会让你选“Project Template”比如命令行程序、Spring Boot 之类的。第一次建议直接创建普通 Java 项目或命令行程序先跑通再说。4.2 编写并运行 HelloWorld项目创建完成后在左侧的项目树中找到 src 目录右键 → New → Java Class输入名字Main然后写下public class Main { public static void main(String[] args) { System.out.println(Hello, IDEA!); } }点击右上角的绿色三角按钮选择 Run下方控制台就会输出Hello, IDEA!。到这里你的 Java 开发环境就算真正搭好了。这一步远比想象中重要它证明从 JDK 到 IDEA 再到项目配置的整条链路是通的。我见过不少人装完 IDEA 后一直没有实际运行过一个程序然后过了两周跟我说“IDEA 好像有问题代码跑不起来”结果一检查项目里根本没配置 JDK所有类都飘红但连一次都没跑过。4.3 给项目加一点“真实感”配置 Maven前面新建项目时如果你的 Build System 选了 MavenIDEA 会自动识别 Maven 并下载依赖。但国内网络环境下Maven 默认从中央仓库下载依赖很慢强烈建议配置阿里云镜像。找到 Maven 安装目录下的 conf/settings.xmlIDEA 内置的 Maven 可以在 Settings → Build Tools → Maven 里看到 Maven home path在mirrors标签里添加mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror如果使用的是 IDEA 内置的 Maven找不到 settings.xml 的话可以在 Settings 里指定一个你自定义的 settings.xml 文件路径。这一步能让你在引入 FastJSON、MySQL 驱动、JUnit 等第三方库的时候速度从“十几分钟转圈”变成“几秒钟搞定”。5. 开发常用配置与维护5.1 让编辑器更顺手字体、快捷键与主题默认设置不一定适合所有人这里有几个我每次都调的项字体和字号Settings → Editor → Font建议用 JetBrains Mono 或者 Consolas字号 14-16配合高分屏看着不累鼠标滚轮缩放Settings → Editor → General勾选“Change font size with CtrlMouse Wheel”macOS 上是 Command滚轮代码想大就大、想小就小自动导包Settings → Editor → General → Auto Import勾选“Add unambiguous imports on the fly”写代码时引入类不用再自己去按 AltEnter快捷键模板如果你是用 Eclipse 的习惯Settings → Keymap 里可以切换成 Eclipse 方案方便无缝过渡这些配置属于“改了就不想回去”的典型项。特别是代码缩放我在讲问题或者看直播的时候经常看到有人代码字号小得看不清一问就是没开滚轮缩放。5.2 JSP 页面没有语法高亮先确认版本搜索词里有个很典型的提问“IDEA 中 color scheme 中没有 JSP”。这其实和配色方案没关系核心原因是IDEA 社区版Community不支持 JSP 的完整语法高亮只有旗舰版Ultimate才有 JSP/JSF 等 JavaWeb 前端模板的完整支持。很多大学课程会教 JSP学生在社区版里写完 JSP 页面发现 HTML 标签没事Java 代码段和 EL 表达式完全没高亮就以为是自己配置问题。如果你只是非正式学习可以暂时忽略这个问题代码照样能运行如果你要长期做 JavaWeb 开发建议申请 JetBrains 学生授权或者和公司申请旗舰版。这个问题的本质不是“哪里没配好”而是“这个版本本身就不支持”。5.3 必装插件给新手从零到一插件装多了启动慢我建议很多人第一次只装这几个Chinese Language Pack官方的中文语言包适合英文菜单看着头疼的人但注意有些菜单翻译后反而不容易和教程对应看个人需求Rainbow Brackets彩虹括号让多层嵌套的括号颜色分层肉眼找配对括号快很多Lombok如果你用 SpringBoot 开发这个插件配合注解处理器能省掉大量 getter/setter 样板代码Alibaba Java Coding Guidelines阿里巴巴代码规约插件能检查代码风格和低级坑对培养编码习惯很有帮助安装方式Settings → Plugins → Marketplace搜索插件名点击 Install。装上之后有些需要重启 IDE 才生效。5.4 运行内存设置让 IDEA 更流畅IDEA 属于“吃内存大户”。如果你电脑内存足够大16GB 以上可以给 IDEA 多分配一些运行内存减少卡顿。在菜单栏 Help → Change Memory Settings 里直接设置堆内存大小。如果使用 64 位系统推荐设置 2GB 起步做大型项目时可以给到 4GB。老电脑内存只有 8GB 的话建议关掉一些不用的插件别开一堆项目IDEA 也不容易卡。操作前建议保存所有文件。修改内存设置后 IDEA 会提示重启重启后生效。如果设置过大的值导致启动失败可以通过配置文件.vmoptions里的-Xmx参数改回安全范围。5.5 IDEA 自带的 Local History比你想的有用这是个“新手不怎么会用但关键时刻能救命”的功能。Local History 是 IDEA 本地的文件变更记录不需要 Git 也能查看文件在某段时间前后的版本差异。右键文件 → Local History → Show History可以看到本地文件修改的历史版本。如果你某天写代码不小心删掉一大段逻辑事后又没提交 Git这个功能能让你找回旧版本。工作中我至少用这功能救了三次大命推荐大家记住这个入口。6. 常见问题与实战排查6.1 安装或启动报错找不到 JDK / No JVM新版 IDEA 通常会自带 JBR所以它本身启动不依赖系统 JDK但这不代表你项目能运行。一旦项目里报 “Cannot determine path to tools.jar” 或者 “Error:java: 无效的源发行版”基本就是项目 JDK 没配对。排查思路是Settings → Build Tools → Maven → Importing 里确认 JDK for importer以及 File → Project Structure → Project 里确认 SDK 和 Language level两者必须对齐。新手最容易犯的错是SDK 选 17但 Language level 却选成了 8导致新语法编译不过或提示“无效的源发行版”。6.2 新建项目后 Maven 依赖一直下载失败这一类报错绝大多数是网络问题从 2022 年之后尤其常见。解决优先级从高到低是配置阿里云镜像前面已经给了配置方式检查是否是全局代理设置导致 Maven 无法联网Settings → Appearance Behavior → System Settings → HTTP Proxy如果是手动代理确认代理地址正确如果不需要代理选“Auto-detect proxy settings”Maven 仓库目录默认在用户目录的 .m2/repository 下如果之前下载到一半失败会出现.lastUpdated后缀的缓存文件需要把对应目录删掉重新下载这里给一个通用做法直接在 IDEA 的 Terminal 里执行mvn -U clean compile能更容易看到具体是哪一个依赖卡住了。6.3 Lombok 报错“You arent using a compiler supported by lombok”这个问题也是搜索热词之一。报错全文一般是java: You arent using a compiler supported by lombok, so lombok will not work...常见原因有两个一是项目里用了较新版本的 JDK比如 21/23但本地 Lombok 版本太旧二是 IDE 没有开启 Annotation Processing。应对步骤先打开 Settings → Build → Compiler → Annotation Processors勾选 Enable annotation processing再把 Lombok 插件装好并重启。如果还报错去 pom.xml 里把 Lombok 版本升到较新版本比如 1.18.30 及以上版本越高对 JDK 新版本兼容越好。升级后执行一次 Maven Reload Project。6.4 JSP 没有高亮颜色方案里找不到 JSP前面已经提到社区版不支持 JSP 高亮这里再给两个应对方案一是切换到旗舰版二是实在不能切的时候可以把它当成普通文本看功能上不影响调试。如果你主要开发 JavaWeb长期方案还是使用者正版授权。6.5 IDEA 插件市场打不开或下载插件失败插件市场无法联网先检查自己的网络能不能访问 JetBrains 官网。如果网络没问题那大概率是插件市场域名被本地代理拦截。IDEA 里重新配置 HTTP Proxy 后重启 IDEA 就好。如果还是不行可以到 JetBrains 插件官网手动下载插件 zip 包然后在 Settings → Plugins → 齿轮图标 → Install Plugin from Disk选择下载的 zip 文件完成离线安装。6.6 Windows 7 能不能用新版 IDEA2022 年开始 JetBrains 官方就宣布新版 IDEA 不再支持 Windows 7。如果电脑系统是 Win7建议折腾两个方向要么装旧版本 IDEA2020.3 或 2021.1要么趁早换新系统或新电脑。装旧版时记得同时搭配 JDK 8 使用别用新 JDK因为旧版 IDEA 无法正确识别高版本 JDK 的部分特性。6.7 控制台乱码 / 输出中文变为问号控制台中文乱码主要有两个原因一是系统默认编码非 UTF-8二是 IDEA 的全局编码设置没有保持一致。设置里搜索 “File Encoding”把 Global Encoding、Project Encoding、Properties Files 全部设为 UTF-8。Windows 用户还需要在 Help → Edit Custom VM Options 里加上-Dfile.encodingUTF-8重启后生效。这个问题在很多老项目里尤其常见旧项目如果是 GBK 编码就要保持项目编码和源码文件编码一致别混着改。6.8 老电脑运行 IDEA 很卡IDEA 是个 IDE不是记事本卡是正常的但可以通过几个手段优化换 SSD、加内存如果是机械硬盘IDEA 启动和索引确实让人崩溃关掉不必要的插件不要同时打开多个大项目在 Settings → Appearance Behavior → System Settings 里关闭“Reopen projects on startup”减少启动时加载的项目数量我见过最“离谱”的流畅方案是把项目里所有的 node_modules、target、dist 目录在 File → Settings → Editor → File Types 里忽略掉IDEA 不再为这些文件建立索引速度立竿见影。7. 最后再分享一点我自己的实操体会带过不少新人我自己的经验是搭环境这件事顺序永远比步骤重要。先 JDK再 IDEA再 Maven最后才是插件和美化。每一步做完了都停下来验证一下不要一口气装完之后面对满屏报错不知道从哪查起。还有一个很多人忽视的点优先在 IDEA 内置的 Terminal 里跑命令而不是开外边的系统命令行。因为 IDEA 内置终端会自动加载项目环境变量对排查 JDK 问题更直观。如果你看完这篇文章能复现出完整的 “HelloWorld”这个环境的搭建就算彻底完成了。接下来的 Java 学习路线不管是面向对象基础、集合框架、IO、多线程还是后面的 MySQL、MyBatis、Spring 生态都是在这个环境上逐步扩展的。基础环境越扎实后面学习新东西越不容易被环境问题打断。
