新手学Java第一步永远绕不开两样东西JDK和IDEAIntelliJ IDEA。我见过太多人卡在环境配置这一步教材看了一大堆代码一行没写光是配个环境变量就劝退了一大半。其实这件事本身没有任何技术难度纯粹是信息太碎、教程太老、踩坑太多导致简单的事情被搞复杂了。这篇文章就把JDK和IDEA的下载、安装、环境变量配置、IDEA关联JDK、创建第一个项目整个过程完整走一遍。我会把每一步操作的意图讲清楚把需要避开的坑提前标出来也会把环境变量配置失败、找不到JDK、IDEA闪退这类常见问题单独拎出来说。无论你是完全零基础的新手还是想把手上的环境重新清理一遍的开发者按这篇文章的顺序做基本不会出问题。1. 整体思路与版本选型1.1 为什么JDK和IDEA要配套使用很多刚入门的同学会混淆几个概念JDK、JRE、IDE。简单说JDK是Java Development Kit即Java开发工具包它包含了编译工具javac、运行环境JRE、调试工具等一整套能力。JRE是Java Runtime Environment只负责跑Java程序不提供开发能力。IDE集成开发环境则是用来写代码的操作台IDEA就是其中非常主流的一款。换一个生活化的类比JDK好比一套完整的厨房设备灶台、锅、刀具JRE是别人已经做好的成品菜而IDEA就是你工作的厨房台面。你只能在厨房台面上用整套设备从切菜到烹饪最后做出一道菜来。三者缺一不可。IDEA本身是用Java写的所以它运行也需要一个JDK环境。安装顺序必须是先说“先装JDK、再装IDEA”因为IDEA在启动和创建项目时需要调用JDK提供的工具链。如果顺序反了或者JDK环境变量没配好IDEA经常会报“找不到JDK”之类的错误后面我会在问题排查部分详细说。1.2 JDK版本怎么选LTS是底线JDK的版本迭代非常快现在已经出到21甚至更高了。但版本多并不意味着选最新的就最好。这里我建议一个原则非特殊需求优先选LTSLong-Term Support长期支持版本。LTS版本意味着官方会提供长期的更新和维护适合稳定学习和生产使用。目前主流的LTS版本有JDK 8、JDK 11、JDK 17、JDK 21。JDK 8是很多老项目和教材还在用的版本生态非常成熟网上教程也最多。但实话实说JDK 8真的太老了很多新特性缺失而且IDEA新版对JDK 8的兼容性提示也变多了。如果你完全是新入门我更推荐JDK 17它是目前主流采用率最高、教程最丰富、IDEA支持最好的一个版本。JDK 21虽然更新但一些教程和框架还没有完全跟上容易遇到冷门问题。选版本还有一个隐藏逻辑学校教材或者网课如果指定了版本就直接按指定版本装不要自己换。因为某些老课程里的代码在JDK 17下编译会报错而新版JDK已经移除了部分旧API。反之如果课程是新的用了记录类、switch表达式等新语法JDK 8又跑不起来。先看教程要求再定版本。1.3 IDEA版本与JDK版本怎么搭IDEA分为两个版本社区版Community和旗舰版Ultimate。社区版免费、开源功能上屏蔽了Spring、数据库工具等企业级功能但对学习Java SE基础语法、写控制台程序、做课程设计完全够用。旗舰版收费功能全适合做Web开发和Spring Boot项目。骄傲地说社区版足够覆盖大半的入门需求没必要一上来就找激活破解相关的资源直接用免费版本少踩很多没必要的坑。IDEA版本与JDK版本的配合方面新版IDEA2023年起对JDK 17的支持已经非常成熟默认模板也偏向JDK 17。只要JDK选的是17IDEA就用最新的稳定大版本两者不会冲突。2. JDK下载、安装与环境变量配置2.1 JDK安装包去哪下载下载JDK一定要认准官方渠道Oracle官网oracle.com。不要用搜索网站搜“JDK下载”很容易下载到捆绑了全家桶的第三方安装包。这里有一个非常实用的技巧搜索时加“官网”二字或者直接记住官方域名从根源上避免垃圾软件的干扰。Oracle官网的JDK下载页面叫“Java Downloads”进去之后会看到不同版本的JDK列表。选择你需要的JDK 17确认系统是Windows还是macOS再确认CPU架构是x64还是ARM64。大多数人Windows电脑选“Windows x64 Installer”就行是一个.msi后缀的安装包。如果你的电脑是苹果M系列芯片就选macOS ARM64的.dmg格式。另外还有一种下载渠道是OpenJDK发行版比如Adoptium、Amazon Corretto等它们是开源的JDK实现完全免费与Oracle JDK在功能上基本等价。新手没必要折腾这些直接用Oracle官网的公开版本步骤最简单。2.2 Windows下的安装过程与路径选择双击.msi安装包后基本一路“Next”就能完成但有几个地方需要留意一下。安装目录默认在C:\Program Files\Java\jdk-17建议直接保留默认不要改到带中文或空格的路径。中文路径在后续配置环境变量时可能引发奇怪的问题空格虽然能处理但会平白增加命令行的转义复杂度。如果你确实想改也请保证路径中只有英文字母、数字和下划线例如D:\dev\jdk-17。安装过程中会弹出“JAVA_HOME”的提示吗实际不会JDK安装包只会把必要的文件解压到指定目录。环境变量需要你自己手动配置这一步才是很多人翻车的核心环节。初学者可能会问为什么要手动配环境变量因为Windows系统不会自动知道JDK装在了哪里。你打开命令行输入java系统需要去某个目录下找寻java.exe。环境变量就是告诉系统“JDK在这个位置你从这个位置找”本质上是一个路径指引。2.3 环境变量核心配置JAVA_HOME、Path、CLASSPATH配置环境变量的路径是右键“此电脑” - “属性” - “高级系统设置” - “环境变量”。在打开的窗口里你会看到两个区域用户变量和系统变量。第一步新建JAVA_HOME变量。在“系统变量”区域点击“新建”变量名填JAVA_HOME变量值填JDK的安装目录比如C:\Program Files\Java\jdk-17。注意这里只需要写到JDK的根目录不要多写多余的子路径。第二步修改Path变量。在“系统变量”区域找到Path选中后点击“编辑”在弹出窗口中点击“新建”填入%JAVA_HOME%\bin然后确定保存。这里%JAVA_HOME%是引用刚才设置的环境变量bin目录下存放了java.exe、javac.exe等官方工具命令。配置Path的目的是让你在任何目录下打开命令行都能直接执行java命令。第三步CLASSPATH要不要配。这是网上争议比较多的地方。JDK 5以后JVM已经不再依赖CLASSPATH环境变量来查找基础类库默认会从JDK目录下的lib目录加载所以新版本JDK可以完全不设置CLASSPATH。这个变量在旧教程里经常出现新手配错反而会引发“找不到类”的问题。我的建议无需配置留空即可。2.4 验证安装是否成功环境变量配置完成后需要重启命令提示符窗口重要已经打开的窗口不会自动加载新的环境变量必须重新打开一个CMD窗口然后依次输入两条命令。输入java -version如果能输出如下类似内容说明JDK安装成功java version 17.0.12 2024-07-16 LTS Java(TM) SE Runtime Environment (build 17.0.128) Java HotSpot(TM) 64-Bit Server VM (build 17.0.128, mixed mode, sharing)再输入javac -version如果输出javac 17.0.12说明编译器也可用。假如java -version正常但javac -version提示“不是内部或外部命令”大概率是Path配置只配到了java的路径而没配到bin目录下的javac。回到Path里检查%JAVA_HOME%\bin这一项是否真的存在。3. IntelliJ IDEA下载、安装与首次配置3.1 下载IDEA社区版还是旗舰版IDEA的官网是jetbrains.com进入首页后在“Developer Tools”菜单下选择“IntelliJ IDEA”页面会让你在“Ultimate”和“Community”之间选择。这里不要犹豫学习和基础开发直接下载Community版。社区版免费、开源、无需激活对新手是零门槛。旗舰版功能虽然强大但需要付费订阅网上流传的各种激活方式都不合法且往往捆绑恶意脚本完全没有必要去冒这个风险。如果你以后确实需要旗舰版的企业级功能JetBrains官方也提供30天免费试用可以按规则体验。下载时同样注意系统版本Windows对应.exe安装包macOS对应.dmg。安装包体积不小社区版约600MB网速慢的话耐心等待就好下载过程不要中断。3.2 安装步骤与关键选项Windows下双击.exe安装包会进入Setup向导。有几个勾选项需要特别注意。“Create Desktop Shortcut”建议勾选方便日后启动。“Update PATH variable”选项建议勾选它会自动把IDEA的启动命令加入系统Path方便你在命令行中直接输入idea唤起IDE对于以后要使用命令行工具的场景很有帮助。“Add Open Folder as Project”也建议勾选这是一个右键集成可以在文件夹上直接右键用IDEA打开。安装目录同样建议保持默认除非C盘空间紧张否则不用改。整个安装过程是纯图形化界面一路Next即可。3.3 首次启动主题选择与插件配置安装完成后第一次启动IDEA会进入一个初始化向导。首先会让你选择主题颜色Darcula深色或IntelliJ Light浅色。这个完全是个人偏好深色护眼、浅色清爽我日常使用深色为主你可以按自己喜好来。接着是插件安装界面。此时不建议安装任何插件保持默认直接Start即可。很多新手看到插件列表会手痒装一堆结果把IDE搞得卡顿还容易出现配置文件冲突。等以后确实有需要时比如Lombok、MyBatisX在IDEA内部的插件市场按需安装即可。启动完成后还有一步可能让新手困惑的界面一个写有多个项目的欢迎页。此时先不要新建项目先把IDEA的编码设置调整好。进入“File” - “Settings”Windows或“IntelliJ IDEA” - “Settings”macOS在“Editor” - “File Encodings”界面将Global Encoding、Project Encoding、Properties Files的编码格式全部设为UTF-8。没有这一步将来代码里的中文注释很容易乱码。3.4 在IDEA中配置JDK打开“File” - “Project Structure”快捷键CtrlAltShiftS在“Project”选项卡下找到“SDK”下拉框。如果IDEA已经自动检测到安装好的JDK下拉框里会有对应版本如果没有点击“Add JDK”手动选择JDK安装目录就是刚才安装JDK的路径例如C:\Program Files\Java\jdk-17。这里有一个容易踩的坑如果你在安装JDK时没有配置JAVA_HOME或者Path配置有问题IDEA的自动检测就会失败下拉框只有灰色提示。所以前面环境变量配置一定要做扎实这不仅是命令行能用java命令的问题IDEA也会读取系统环境变量来寻找JDK。4. 创建第一个Java项目并验证环境4.1 新建项目的完整流程在IDEA欢迎页点击“New Project”进入创建向导。这一步有几个设置需要正确填写。第一“Name”填项目名称比如HelloWorld。第二“Location”是项目保存路径建议放在一个专门的目录下比如D:\JavaProjects路径中不要带中文和空格。第三也是最重要的Project SDK下拉框选择你安装的JDK版本比如17。第四在“Additional Libraries and Frameworks”中保持默认不勾选Spring等框架纯Java入门阶段不需要任何额外框架。最后点击“Create”即可。创建完成后IDEA会打开主界面并自动生成项目结构。左侧的项目面板里有一个src目录这是存放Java源码的地方。日常练习的代码就放在这里这个约定不要破坏。4.2 手写Hello World并运行在src目录上右键 - New - Java Class输入类名HelloWorld。注意类名必须和文件名一致首字母大写这是Java规范IDEA也会用黄色波浪线提示你。创建完成后编辑区会出现一个空的类定义输入main方法的三行代码public class HelloWorld { public static void main(String[] args) { System.out.println(Hello, Java!); } }代码解释一下public class HelloWorld定义一个公开类public static void main(String[] args)是Java程序的入口方法JVM会从这里开始执行程序。System.out.println是标准输出语句会在控制台打印后面的字符串。写完代码后点击右上角的绿色三角形按钮运行或者右键编辑区选择“Run HelloWorld.main()”IDEA会在底部打开控制台面板输出Hello, Java!。看到这行输出你的整个环境就完全打通了。4.3 为什么建议用IDEA的快捷键体系IDEA存在非常成熟的快捷键体系从入门第一天就养成习惯获益极大。main方法可以输入psvm后回车自动补全System.out.println可以输入sout后回车自动补全。格式化代码用CtrlAltLWindows或CmdAltLmacOS。查找文件用双击Shift。重命名变量用ShiftF6。有人说记快捷键是花架子实际这是错的想法。IDEA的快捷键不只是提速更重要的是让写代码的过程流畅。你想想如果每写一句就得停下来摸鼠标、找菜单、点按钮心流状态很容易被打断。入门阶段就把这几个高频快捷键记住后面写项目时非常舒服。5. 常见报错与排查技巧5.1 环境变量配置失败现象打开命令行输入java -version提示“不是内部或外部命令也不是可运行的程序或批处理文件”。排查思路非常固定。第一步确认JAVA_HOME是否创建成功且路径正确可以在命令行输入echo %JAVA_HOME%看看输出是否指向JDK目录。如果输出为空说明JAVA_HOME没配好。第二步确认Path里是否包含%JAVA_HOME%\bin。第三步确认这些配置是不是在“系统变量”下完成的而不是在“用户变量”下修改后忘了点确定。一个很常见的细节修改完环境变量后已经打开的CMD窗口不会生效必须重新打开一个。如果还是不行干脆注销Windows或重启一次一次性解决环境变量缓存问题。另外要注意Path变量里不要写死JDK的具体路径比如C:\Program Files\Java\jdk-17\bin如果你以后切换到JDK 21还得回来改Path用%JAVA_HOME%\bin这种引用方式以后升级只管改JAVA_HOME就行。5.2 cmd能找到java但IDEA找不到JDK这种情况很诡异命令行里java -version正常但IDEA里创建项目时SDK下拉框还是空。核心原因通常是环境变量是在你已经有命令行窗口打开之后才配置的命令行窗口重新打开后生效了但IDEA是环境变量配置前启动的它缓存了旧环境变量。解决办法很简单完全退出IDEA重启不是关闭项目而是退出整个应用IDEA重启时会重新读取系统环境变量。如果问题还存在检查IDEA安装版本是否为32位现代JDK 17只提供64位版本32位IDE无法识别。5.3 IDEA启动闪退或崩溃刚装好IDEA启动后还没进入欢迎页就闪退了这个问题通常不是JDK导致的而是IDEA自身的配置损坏或内存参数不合理。删除IDEA配置目录后重启是立竿见影的办法。Windows下IDEA的配置目录在C:\Users\你的用户名\AppData\Roaming\JetBrains\IntelliJIdea2023.xmacOS在~/Library/Application Support/JetBrains/IntelliJIdea2023.x。将这个目录改名比如加一个.bak后缀再重新启动IDEA它会自动生成一份全新配置。如果启动正常了就是你之前调错了什么配置如果还是闪退再考虑卸载重装。5.4 中文乱码问题运行程序后控制台输出的中文变成乱码几乎都是编码不统一造成的。Windows系统控制台默认使用GBK编码而IDEA里代码文件用UTF-8编码两者不一致就会出现乱码。解决办法在IDEA中操作打开“Help” - “Edit Custom VM Options”在文件中追加一行-Dfile.encodingUTF-8保存后重启IDEA。同时在“Settings” - “Editor” - “File Encodings”中把三项都设为UTF-8。最后在“Run” - “Edit Configurations”中为当前运行配置的“VM options”一项加上-Dfile.encodingUTF-8。这样三重保证下中文控制台输出基本不会再乱码。5.5 常见错误速查表错误现象最可能原因快速解决命令行找不到java命令Path未配置或配置错误重新配置%JAVA_HOME%\bin命令行找不到javac命令JDK不是标准安装包用官方MSI安装包重装JDK输入java -version提示JAVA_HOME失效JAVA_HOME路径错误或指向不存在的目录检查JAVA_HOME的值并修正IDEA新建项目SDK下拉框为空环境变量未生效重启IDEA或重启电脑运行时报“错误: 找不到或无法加载主类”运行配置错误或JDK版本不匹配点菜单“Build” - “Rebuild Project”控制台中文乱码Encoding编码不统一按上文编码三件套操作IDEA启动闪退配置损坏删除配置目录或用Toolbox重装编译时报“非法字符: \ufeff”文件用带BOM的UTF-8保存用IDEA转换文件编码为UTF-8无BOM最后分享一个我自己的习惯每次配完环境我会在一个固定的测试目录下故意写一个带中文注释和中文输出的简单程序跑一遍确认编码正常。这一步看似多此一举却能提前暴露环境里的隐性坑免得以后写大项目时被中文注释乱码折磨。环境配置真的不难难的是耐心和一点点排查思路。按照这个流程走完一遍以后无论在什么机器上配Java开发环境都是十分钟的事。