1. 先把顺序理清楚为什么我坚持先装JDK再装IDEA每次带新人搭环境我第一句话都是先把JDK装利索了再动IDEA。顺序反了不是装不上而是后面会冒出一堆莫名其妙的报错比如IDEA里新建项目时提示找不到SDK或者终端里java能跑、javac却报不是内部或外部命令你在网上翻半天教程也未必对得上症状。这类问题九成不是软件坏了是安装顺序和路径规划没做对。JDK和IDEA的关系我一般这么打比方JDK是发动机和变速箱IDEA是驾驶舱和仪表盘。发动机没装稳驾驶舱再漂亮也开不动。JDKJava Development Kit里装着javac编译器、java运行时、jar打包工具这一整套家伙事而IntelliJ IDEA只是把这些命令行工具包装成一个可视化界面帮你写代码、点按钮、看结果。IDEA本身不包含Java运行时除了它自己启动用的那个JBR它运行你的代码时用的还是你系统里那套JDK。理解了这层关系后面的选择就好做了。你要装的其实是两样东西一个能编译运行Java的工具链一个能舒服写代码的编辑器。这两者要能对上号——JDK版本太低、IDEA版本太新可能提示不支持的语言级别JDK装了多个、环境变量指向的那个和IDEA里选的那个不一致就会出现命令行能编译、IDEA里报错的诡异情况。所以这篇教程我会按下载JDK → 安装JDK → 配置环境变量 → 验证 → 装IDEA → 在IDEA里挂JDK → 跑通第一个类这条链路来讲每一环都告诉你为什么这么做出了问题往哪查。1.1 版本怎么挑JDK 17 和 IDEA 2023.x 的组合版本选择是第一个分岔口。我给的默认建议是JDK 17 IntelliJ IDEA 2023.x。原因很实在JDK 17 是长期支持版本LTS语法特性够新密封类、记录类、文本块都有生态兼容性又好绝大多数公司项目、教学课程、开源框架都能直接跑。你可能听说JDK 21也是LTS、更新没错但眼下很多老项目、老依赖还停在17这条线上新人上手先用17不会遇到兼容性劝退。等你熟悉了再装个21切着玩完全没问题多版本共存本来就是这个领域的常态。IDEA这边2023系列我推荐用2023.2 或 2023.3这类较新的小版本界面和功能都稳定。需要注意IDEA分两个版本Community社区版免费和Ultimate旗舰版收费。社区版够用吗写纯Java、做算法题、学基础语法完全够。但它不支持Spring/Spring Boot这类企业级框架的深度集成也没有数据库工具、HTTP客户端、JavaScript高级支持。如果你是学生可以凭学校邮箱申请旗舰版的免费教育授权这个渠道是官方提供的值得去弄一下。我的习惯是先装社区版把环境跑通确定要长期做后端再考虑旗舰版。提示JDK和IDEA的版本不要拉得太开。比如你装JDK 8然后上IDEA 2023.3新建项目时默认语言级别可能不一致虽然能手动调但对新手来说是额外的心智负担。JDK 17配2023系列最省心。2. 下载JDK官网、镜像与安装包形态的取舍下载这一步看似简单其实是新人第一个绊脚石。原因在于Oracle官方JDK从某些版本起下载需要登录账号很多人卡在点了下载按钮跳到登录页。这不是你网的问题是政策变了。所以我把下载渠道分成三条路你按自己情况选。第一条Oracle官方。访问Oracle的Java下载页能拿到JDK 17、21等版本。缺点就是刚才说的登录门槛注册一个Oracle账号也不难只是多几步。它的许可现在对个人开发和学习是免费的商用要看具体条款自己心里有数就行。第二条国内开源镜像站。这是我最常推荐的路线因为下载速度快、不用登录、版本还全。比如华为云、腾讯云的开源镜像清华的TUNA镜像站都提供OpenJDK、AdoptiumEclipse Temurin等发行版的镜像下载。这些镜像站提供的都是标准的、可正常使用的构建版本日常开发和学习用它们完全没问题。清华镜像里能直接找到Adoptium的目录选对应的JDK 17、Windows x64下msi或者zip几秒钟的事。第三条各大厂商的OpenJDK发行版。Eclipse Temurin、Amazon Corretto、Microsoft Build of OpenJDK、Azul Zulu还有国内的阿里Dragonwell、腾讯Kona、华为毕昇JDK都是免费的、可直接下载安装的。它们的差异主要在长期维护策略和某些优化上对新手来说感知不大。我自己的机器上常年放着Temurin和Corretto两套切换测试很方便。2.1 该下安装器exe/msi还是压缩包zip这是很多人没在意、但会直接影响后面操作形态的选择。安装器.exe或.msi双击下一步就行它会自动往系统里注册、帮你把java命令加进Path注意是它自己的路径还能顺便装JRE。适合新手省事。但它有两个隐患一是默认装到C:\Program Files\Java\...这种带空格的路径个别老工具会出问题二是它会偷偷在Path里塞一个类似C:\Program Files\Common Files\Oracle\Java\javapath的目录这个目录里的java.exe是个符号链接它才是java能用javac不能用这种诡异现象的元凶之一后面排查章节我会细讲。压缩包.zip/.tar.gz解压即用不动系统注册表路径完全由你控制。想装几个版本就解压几份切版本只要改JAVA_HOME或者干脆用脚本切。我强烈建议有折腾意愿的人走这条路尤其是需要多版本共存的。我的建议组合是主版本比如17用压缩包解压到一个你专门规划好的目录比如D:\dev\jdk-17。路径里不要有中文、不要有空格这是老规矩。你可以把D:\dev当作你的开发工具基地JDK、Maven、Git都往里放将来重装系统或者迁移整个目录一拷就走。2.2 校验一下再解压下载完别急着用。养成个习惯比对一下文件大小或者用哈希值校验。官网和镜像站通常会给SHA256。Windows上用certutil -hashfile 文件名 SHA256就能算算出来跟网页上的对一下。这一步大部分时候没啥悬念但遇到下载中途断流、镜像同步不全的情况能帮你少走弯路——解压报错、安装失败很多时候就是包本身不完整。花三十秒省半小时。3. JDK安装与环境变量配置搞明白每一步在动什么到了这一步很多教程给的是一串照抄就行的点击和粘贴但我不喜欢这样。环境变量配置失败是这个环节最高频的问题你只有知道每个变量是干嘛的出错了才知道往哪看。先讲三个变量的角色这是我带人时必讲的JAVA_HOME指向JDK的根目录比如D:\dev\jdk-17。它本身不直接让你能在命令行跑java但它是所有Java工具链的导航地标。Maven、Gradle、Tomcat、大部分IDE都靠读这个变量去找到JDK。所以它必须对。Path系统的可执行文件搜索路径。你敲java系统会按Path里的目录顺序一个个找java.exe。我们要把%JAVA_HOME%\bin加进去。CLASSPATH类路径告诉JVM去哪里找你要用的类库。现代开发里这个变量基本不用手动配了IDEA和构建工具会自动管理。老教程里那句.;%JAVA_HOME%\lib\dt.jar;...是给早期环境用的照抄反而可能干扰你。我一般建议如果系统里已经有CLASSPATH先删掉或清空。3.1 配置JAVA_HOME和Path的正确姿势在Windows上打开系统属性 → 高级 → 环境变量。我建议在系统变量里新建JAVA_HOME值填你的JDK根目录注意别带\bin也别带结尾的斜杠就写到jdk-17这一层。然后编辑系统变量里的Path新增一条%JAVA_HOME%\bin。这里有个关键操作细节尽量用编辑把新条目加进去不要整段覆盖Path的原有内容。有人图省事直接把Path全删了重填结果系统自带的那些路径没了一堆功能跟着出毛病。另外把%JAVA_HOME%\bin尽量往列表上面挪一点。为什么因为如果系统里同时存在一个安装器留下的javapath目录Path是按顺序找的谁在前面谁说了算你把%JAVA_HOME%\bin放前面就能优先命中你自己指定那套JDK。Mac和Linux的玩家走的是另一套配置文件是~/.bash_profile或~/.zshrc写上export JAVA_HOME...和export PATH$JAVA_HOME/bin:$PATH然后source一下让配置生效。注意Mac上有个libexec/java_home机制老版本macOS自带的java是个桩程序第一次敲会弹窗提示装JDK别被吓到装完你自己的就正常了。3.2 验证三条命令看出三种状态配完一定要开新的命令行窗口这点很重要旧窗口读的是旧环境然后依次敲java -version javac -version echo %JAVA_HOME% (Windows) / echo $JAVA_HOME (Mac/Linux)三条命令能组合出几种状态你对着看现象大概率原因两条都出正确的17版本号配置成功收工java出17、javac报不是内部或外部命令Path里只有运行时没有编译器一般是被安装器装成了只装JRE两条版本号不一致一个17一个别的Path里有多套顺序没排好echo %JAVA_HOME%显示的是%JAVA_HOME%本身变量没建对或者建在了用户变量而你在别的账户下java -version输出里那行openjdk version 17.0.x和javac -version的javac 17.0.x一定要对得上。版本号对不上说明你敲的命令走的不是同一条路径。这时候用where javaWindows或which javaMac/Linux看看它到底调用了哪个文件一目了然。4. 环境变量配置失败从报错倒推的完整排查链路这一节我单独拎出来因为jdk环境变量配置失败是搜索量极高的问题而绝大多数教程只给正确步骤不给你排查思路。我按真实动手顺序还原一遍。第一步先确认报错原文。是不是内部或外部命令说明Path没找到还是Error: could not open ...说明能找到java但这个文件有问题还是能运行但版本不对说明找到了错的。这三类根因完全不同先分类别乱改。第二步从Path查起。打开环境变量界面看Path里有没有%JAVA_HOME%\bin注意有没有拼写错误——%JAVA_HOME%bin少个反斜杠、用成%JAVA_HOME%/bin有些场景也能认但最好统一、%JAVA_HOME%\bin里的变量名大小写不一致等等。然后打开命令行敲echo %PATH%看实际展开的结果里有没有你那条。如果Path里写了但没展开说明JAVA_HOME没生效倒回去查它。第三步查JAVA_HOME本身。常见错误是值多写了一层比如写成了D:\dev\jdk-17\bin多写了bin或者写成了上一级目录D:\dev。敲echo %JAVA_HOME%确认然后手动去文件管理器里看这个目录下是不是正好有bin、lib、include这几个文件夹。对不上就是路径写错了。第四步排查那个隐藏的javapath。这是我前面埋的伏笔。如果Path里第一项是C:\Program Files\Common Files\Oracle\Java\javapath那么无论你JAVA_HOME配得多对命令行优先命中的都是它。这个目录里的java.exe、javac.exe是安装器做出来的软链接指向安装器装的那套JDK。当它和你的JAVA_HOME指向两套不同的JDK时就会出现java可行、javac不行或者两个版本号打架的经典症状。解法就是把%JAVA_HOME%\bin挪到它前面或者干脆把这个javapath条目删掉前提是你确定不再需要安装器那套。第五步注意用户变量与系统变量的优先级。Windows里用户变量的Path会追加在系统变量之后但如果用户变量里也定义了同名的JAVA_HOME那它会覆盖系统变量。所以如果你两台机器配置不一样或者公司电脑上有域策略推送的变量先看看用户变量那一栏里有没有干扰项。注意每次改完环境变量必须重开命令行窗口甚至有时候要重启资源管理器因为已经打开的进程读的是启动那一刻的环境快照。改完不生效就先重开窗口这一步能解决大概三成的我明明改了啊。第六步兜底验证。上面都查完还不行就绕开环境变量直接用绝对路径调用D:\dev\jdk-17\bin\javac -version。如果这样能跑那问题百分之百在环境变量跟JDK本身没关系如果这样都跑不了那才是JDK包有问题回去重新下载解压。我把排查顺序整理成一张表遇到问题照着走排查步骤命令/操作结论确认报错类型看命令行原文分三类找不到/文件坏/版本错查Path展开echo %PATH%有没有你的bin路径查JAVA_HOMEecho %JAVA_HOME%值对不对、层级对不对实际调用者where java/where javac命中的是哪一套绕开变量直调绝对路径执行定位是环境问题还是JDK问题重开会话关掉所有命令行重开排除快照未刷新5. IntelliJ IDEA 2023的下载与安装细节环境跑通轮到IDEA。下载去JetBrains官网认准版本号2023.x选Community或Ultimate。下载速度如果慢同样可以留意国内的一些软件镜像源但IDEA的安装包不算大一般能接受。5.1 安装向导里那几个勾选项到底勾不勾Windows安装器会问你几件事我一个个说Create Desktop Shortcut创建桌面快捷方式看个人喜好勾上方便。Update PATH Variable把IDEA命令行工具加进Path勾上之后你可以在命令行用idea .打开当前目录为项目对喜欢命令行操作的人很有用。Update Context Menu右键菜单加Open Folder as Project勾上之后在文件夹上右键就能直接拿IDEA打开日常很顺手。Create Associations文件关联会问你要不要关联.java等文件类型。这个我一般谨慎勾选因为它会把.java的默认打开方式改成IDEA如果你同时还装了VS Code、Eclipse后面双击文件会乱。想要哪个默认你用右键打开方式自己指定就行。Download and install 32-bit JetBrains Runtime现在基本都是64位机器了不用管。安装路径我同样建议放到非系统盘、无中文无空格的目录比如D:\dev\IDEA2023。理由和JDK一样好管理、好迁移、少踩路径的坑。5.2 首次启动的引导导入配置与主题第一次启动IDEA会先问你要不要导入旧版本的配置。如果你是全新安装就选不导入干干净净开始。如果你是升级配置文件里存着你的快捷键、插件、主题导入能省事但也可能把旧版本的某些不兼容设置带进来。我个人的习惯是升级时先导出旧配置备份然后新版本里手动恢复真正需要的部分。主题这块2023版默认是深色的Darcula看代码久了对眼睛友好。UI也有新的UI和经典UI可选新人用默认的新UI就行。字体、字号这些在Settings → Editor → Font里调我一般把字号调到16左右行高1.2倍长时间看代码不累。6. 把JDK挂到IDEA上从新建项目到跑通第一个类这是步数最多、也是新人最容易迷糊的一段。核心要分清两个概念项目SDK和语言级别Language Level。项目SDK指的是这个项目用哪套JDK来编译和运行是个具体路径。语言级别指的是允许我用这套JDK里的哪些语法特性比如你装的是JDK 17但语言级别设成了8那JDK 17的新语法你就用不了IDEA会给你标红。版本不匹配的报错十有八九是这两个设置打架。正确做法是SDK选你装的那套语言级别选跟SDK对应的那个比如SDK 17就选17。6.1 新建项目的完整路径打开IDEAFile → New → Project。在左侧选Java然后重点看右侧Name项目名随便起别用中文。Location项目存放目录我习惯单独建一个D:\code\作为所有项目的老家。JDK这里如果下拉里已经有你配好的JDK直接选。如果没有选Add JDK或Download JDK。注意Download JDK是让IDEA联网帮你下可以但我更推荐点Add JDK后手动指向你已有的JDK根目录这样版本可控也省得重复下载。Build system构建系统。写小练习选IntelliJ最省事要正经做项目选Maven或Gradle。新手先选IntelliJ跑通了再上Maven别有心理负担。建完之后进File → Project Structure快捷键CtrlAltShiftS在Project页确认SDK和Language level都对得上。这一步多花二十秒能避免后面明明我装了17为什么语法标红的困惑。6.2 控制台输出中文乱码怎么一次性解决跑Java程序System.out.println(你好)输出乱码是标配问题。根因是编码不一致——源文件是一种编码JVM运行时的默认字符集又是另一种两边对不上就乱码。解法是让全链路统一到UTF-8Settings → Editor → File Encodings把Global Encoding、Project Encoding都设成UTF-8底下有Default encoding for properties files也设UTF-8并勾上Transparent native-to-ascii conversion。运行时编码在Help → Edit Custom VM Options里加上-Dfile.encodingUTF-8让IDEA启动时就把默认字符集定死。编译参数Maven项目的话在pom.xml里配project.build.sourceEncodingUTF-8/project.build.sourceEncoding。三处都设UTF-8乱码问题基本绝迹。这个事我在带人时反复强调不是偶尔乱码忍忍就过而是编码问题会成为后面读文件、连数据库、写日志时持续冒出来的暗雷一次配好最省心。6.3 多版本JDK共存与项目级切换现实里你经常会遇到公司项目要JDK 8我自己想用17的情况或者像热搜词里提到的jdk降级到17。多版本共存的正确姿势是系统层只有一个JAVA_HOME但IDEA层可以为每个项目单独指定SDK。你把JDK 8和JDK 17都解压到D:\dev\下在IDEA里File → Project Structure → SDKs里把两套都添加进来然后在Project页按项目选。这样命令行用哪套、每个项目用哪套互不干扰比反复改系统环境变量清爽得多。如果确实要在命令行切版本别去暴力改系统变量。写两个小脚本一个设成8、一个设成17需要哪个跑哪个只影响当前这个命令行窗口关掉就恢复。这个习惯能让你避免我明明切回来了怎么还是旧版本的困惑。7. IDEA 2023装完先配这几项后面少走一堆弯路环境跑通了别急着写业务。花二十分钟把下面几项配了收益很大。7.1 Maven与国内仓库镜像如果你做Java后端Maven几乎是绕不开的。Settings → Build, Execution, Deployment → Build Tools → Maven先确认Maven home path用的是你自己装的还是IDEA内置的。内置的能用但版本不一定是你想要的我建议自己下一个Maven解压到D:\dev\然后这里指过去版本可控。然后关键一步配置镜像仓库。默认从中央仓库拉依赖国内网络下经常慢得让人抓狂有时候还超时。打开Maven安装目录下conf/settings.xml在mirrors里加一条指向国内镜像的配置阿里云、腾讯云、华为云都有公共镜像拉依赖的速度能差出十倍不止。配完记得在IDEA的Maven设置里把User settings file指到你这个改了镜像的settings.xml别用默认那份。7.2 常用插件和快捷键IDEA的强大很大一部分来自插件。Settings → Plugins里这几个我基本每个环境都装Translation选中英文变量名或文档能直接翻译看英文源码舒服很多。Rainbow Brackets给成对的括号上色嵌套深的时候不容易看串行。Key Promoter X你每用鼠标点一个功能它提示你对应的快捷键逼着你不自觉养成用键盘的习惯。快捷键不用背全先记几个高频的CtrlShiftF全局搜索、CtrlAltL格式化代码、ShiftF6重命名、CtrlB跳转到定义、AltEnter快速修复建议。用熟这几个效率立竿见影。7.3 Git集成的基础配置Settings → Version Control → Git确认IDEA能不能找到你装的Git。没装的先去Git官网下装完在命令行配好用户名邮箱git config --global user.name和user.email。然后在IDEA里打开项目VCS → Enable Version Control Integration选Git就能在界面上做提交、拉取、看差异了。这些基础配置一次搞定后面用起来顺畅。8. 几个我反复踩过的小细节聊到这儿环境基本就搭利索了。最后分享几个我这些年反复踩、也反复提醒别人的细节都是文档里不写、但真会让人卡住的东西。第一别在同一台机器上装太多套JDK却不做记录。时间一长你根本不记得哪个目录是哪套、哪个是安装器装的、哪个是解压的。我的做法是在D:\dev\下建一个README.txt把每个JDK的版本、来源、用途记一行。听起来土但重装环境或者帮别人排查时这本流水账救命。第二环境变量改完不生效九成是没重开窗口。这一条前面说过但我还要再强调一次因为它太常见了。改完就echo验证、验证不对就懵其实只是当前窗口没刷新。关掉所有命令行、甚至注销一次再登录往往就好了。第三IDEA里的SDK路径和系统JAVA_HOME不一致不一定是坏事。只要你清楚哪个项目用哪套是可控的。真正需要警惕的是你以为在用17实际上在用8这种认知偏差。定期在IDEA的Project Structure里扫一眼比什么都强。第四报错先看第一行和最后一行。装环境时的报错信息往往是中间一堆路径第一行告诉你错在哪最后一行告诉你是什么错。抓住这两行比逐字翻译全文高效得多。第五把好用的配置沉淀下来。IDEA的配置可以导出File → Manage IDE Settings → Export Settings导出一个zip。下次换电脑或者重装导入就能恢复你全部的快捷键、插件、主题设置。我用这招在几台机器之间同步环境省下的时间够写不少代码了。搭环境这件事第一次做觉得繁琐做过几遍就形成肌肉记忆再往后你甚至能一边跟人聊天一边把整套跑通。关键是每一步都要知道自己在干什么而不是照着别人的截图点一遍——点完就忘出了问题还得从头查。