JDK 和 IDEA 的安装算是每个 Java 开发者的入门第一课也是最容易被各种教程带偏的一步。我见过太多人卡在环境变量上折腾一整晚也见过有人 IDEA 装完打开就一堆乱码。这篇教程把我这几年在 Windows、macOS 上反复装环境踩过的坑整理出来从 JDK 版本选择、下载源、环境变量配置到 IDEA 社区版安装、首次启动设置、识别 JDK 报错的排查一条龙讲清楚。不管你是刚学 Java 的小白还是重装系统后需要快速恢复环境的老手照着走基本能一次装好。文中所有步骤都是我本机实际验证过的工具全部走免费路线不涉及任何付费或授权规避的内容。1. 装之前先想清楚JDK 版本怎么选、从哪下很多人装 JDK 的习惯是随便搜个教程照着下最新版结果装完发现跟教程里讲的对不上或者项目跑不起来。问题往往出在版本和来源上。这一节先把两个最容易踩坑的决策点讲透选哪个版本、从哪下。1.1 为什么我建议新手直接上 JDK 17 而不是 JDK 8网上老教程清一色 JDK 8原因是当年企业主力就是 8。但现在的现实是JDK 17 是长期支持版本LTS主流框架 Spring Boot 3.x 已经强制要求 JDK 17 及以上如果你现在学的是新项目用 8 会直接卡在依赖版本上。JDK 21 也是 LTS但一些老一点的教学资料、第三方库兼容性还没完全跟上作为纯新手的第一套环境17 是兼容性和新特性之间最平衡的点。判断依据其实不复杂LTS 版本能拿到更长期的安全更新社区文档也最全。JDK 8、11、17、21 都是 LTS非 LTS 的版本比如 15、16、18、19、20官方支持周期很短学习阶段没必要碰。给你一个简单的选择口径纯新手学语法、写练手项目JDK 17公司项目明确要求按公司要求通常是 8 或 11想尝新特性、跑最新 Spring Boot17 或 21我个人的做法是机器上同时装 17 和 8 两个版本通过环境变量切换。下面第 2 节会具体讲怎么共存和切换这个技巧在实际工作里非常重要因为你大概率会遇到老项目要 8、新项目要 17的场景。1.2 下载源怎么选官网、国内镜像、包管理器的取舍先说结论能直连官网就官网速度慢就换国内镜像macOS/Linux 优先用包管理器。这三种方式我都用过各有适用场景。官网Oracle 和 OpenJDK 发行版的问题不是能不能下而是下载速度。Oracle JDK 现在的授权政策对商用有额外要求学习用没问题但如果你以后进公司很多团队用的是OpenJDK 的发行版比如 Eclipse Temurin、Amazon Corretto、Azul Zulu。这些发行版完全免费、开源商用也没授权顾虑我强烈建议新手直接用Eclipse Temurin 的 JDK 17它在 Adoptium 官网能下到也有国内镜像。国内镜像这块清华的 TUNA 镜像、华为云镜像都提供 JDK 和 Maven 等常用开发工具的下载速度能跑满带宽。搜索时用清华镜像 jdk或者华为镜像 openjdk这类关键词就能找到注意进镜像站后找Adoptium或OpenJDK目录别下错了架构x64 还是 aarch64取决于你的 CPU。注意下载时一定看清是Windows x64、Windows aarch64还是macOS aarch64。现在不少轻薄本是 ARM 架构下错架构装上去会各种报错或者直接装不上。包管理器的方式在 macOS 上是brew install openjdk17Ubuntu 上是apt install openjdk-17-jdk。好处是升级、卸载、多版本管理都省心坏处是路径不像 Windows 那样直观。如果你只是想快速有个能跑的环境包管理器真的省事。1.3 安装前的三分钟机器检查动手之前花三分钟确认几件事能避免大部分装到一半发现不对的情况磁盘空间JDK 占几百兆IDEA 装完加上缓存、索引动辄好几个 G建议 C 盘至少留 20G。是否已装旧 JDK在命令行敲java -version如果已经有输出说明机器上已经有 JDK别急着装新的先确认旧版本在哪、要不要保留。系统版本Windows 10/11 都没问题macOS 建议 12 以上IDEA 2023 版本对系统最低版本有要求太老的系统可能装不上。这三点看着简单但我见过太多人是装完了才发现 C 盘爆了或者机器上早就装了 JDK 8 只是自己不知道导致新装的 17 一直不生效。提前查一下省下的时间够你多写几行代码了。2. JDK 安装与环境变量配置全流程环境变量配置是新手最容易翻车的环节也是jdk 环境变量配置失败能上热搜的原因。这一节我把 Windows 的完整流程拆开讲同时把 macOS/Linux 的差异也带上最后讲多版本共存和切换——这是很多人装完第一个 JDK 之后最需要的技能。2.1 Windows 下的安装与目录规划下载好xxx.exeTemurin 是.msi之后双击安装。安装路径这里有讲究默认路径带空格比如C:\Program Files\Eclipse Adoptium\jdk-17带空格在某些老工具链里会出问题。我的习惯是统一装到一个不带空格的目录比如C:\dev\jdk\jdk-17以后装别的版本就放到C:\dev\jdk\jdk-8方便管理。安装过程中会问你几个选项重点看这两个Set JAVA_HOME variable勾上这样安装器会自动帮你在系统变量里加一个JAVA_HOME。Add to PATH勾上这样java命令能直接在命令行用。如果你偷懒全勾了其实环境变量那一节可以跳过大半。但我不建议完全依赖安装器因为当你要装第二个 JDK 的时候自动配置会打架还不如从一开始就手动配、心里有数。.msi和.exe的区别.msi是标准安装包会写入注册表、能自动配置环境变量卸载也干净.zip是绿色版解压即用环境变量全手动配。老手有时候喜欢用 zip 版可控性更强。2.2 三个环境变量JAVA_HOME、PATH 和那个其实可以不配的 CLASSPATHWindows 上手动配置环境变量打开此电脑 → 属性 → 高级系统设置 → 环境变量操作下面这几个。第一个JAVA_HOME。这是最核心的一个作用是告诉系统和很多工具IDEA、Maven、Gradle你的 JDK 装在哪。新建系统变量变量名JAVA_HOME变量值C:\dev\jdk\jdk-17换成你的实际路径不要带\bin这里有个新手高频错误把路径写成C:\dev\jdk\jdk-17\bin。不用带 bin因为后面 PATH 里我们会引用%JAVA_HOME%\bin。JAVA_HOME 指向 JDK 根目录这是约定。第二个PATH。找到系统变量里的Path编辑新增一行%JAVA_HOME%\bin为什么用%JAVA_HOME%\bin而不是写死完整路径因为哪天你把 JDK 从 17 换到 21只要改 JAVA_HOME 一个变量PATH 不用动。这是多版本切换的基础。第三个CLASSPATH。老实说现代 Java 开发基本不需要手动配 CLASSPATH 了很多教程还在讲是因为历史惯性。JDK 5 之后没有 CLASSPATH 也能正常运行程序。你要是照着老教程配了问题也不大就是没必要。我现在的做法是干脆不配干净。配置完记得全部点确定关闭每一层窗口然后重新打开一个新的命令行窗口——注意是重新开已经开着的那个不会读取到新的环境变量。这又是一个高频坑配完了在旧窗口里试怎么都不生效以为配错了。2.3 验证与多版本切换的实操技巧验证很简单新开一个命令行窗口依次敲java -version javac -version echo %JAVA_HOME%三条命令分别输出运行环境版本、编译器版本和 JAVA_HOME。如果java -version出来的版本跟你装的一致环境变量就成功了。如果提示不是内部或外部命令八成是 PATH 没配对或者忘了开新窗口。多版本切换怎么做核心就一句话JAVA_HOME 指向哪个版本命令行就用哪个版本前提是 PATH 里用的是%JAVA_HOME%\bin。我的做法是准备两个切换脚本放到方便调用的目录:: use-jdk17.bat setx JAVA_HOME C:\dev\jdk\jdk-17双击运行后关掉所有命令行窗口重开就切到 17 了。想要切 8 就再来一个use-jdk8.bat。setx是永久修改注意它不影响当前窗口必须重开窗口生效。有更优雅的方案是用工具管理比如 Windows 上的JEnv类工具或者直接在 IDEA 里按项目指定 JDK后面讲但脚本切换最直观够用了。提示切换版本后一定要关掉重新打开命令行setx改的是系统级变量当前进程读不到。这个细节坑过无数人。2.4 macOS 与 Linux 上的不同玩法macOS 上用 Homebrew 装brew install openjdk17。装完 Homebrew 会提示你 JDK 的路径通常是/opt/homebrew/opt/openjdk17Apple Silicon或/usr/local/opt/openjdk17Intel。系统默认不会自动把它加进 PATH你需要在~/.zshrc里加export JAVA_HOME/opt/homebrew/opt/openjdk17 export PATH$JAVA_HOME/bin:$PATH改完执行source ~/.zshrc生效。macOS 自带一个/usr/bin/java的壳它会去找系统里的 JDK。如果你装了多个版本可以用/usr/libexec/java_home -V列出所有已安装的 JDK然后用export JAVA_HOME$(/usr/libexec/java_home -v 17)精确指定。Linux 上用apt install openjdk-17-jdk或yum install java-17-openjdk-devel装完路径通常在/usr/lib/jvm/下。用update-alternatives --config java可以在多个版本间切换这个工具很好用不用手改环境变量。3. IntelliJ IDEA 安装与首次配置JDK 装好接下来是 IDEA。这一节讲清楚社区版和旗舰版的区别、安装选项怎么选、首次启动那些容易被忽略但很影响体验的设置最后把 JDK、Git、Maven 这些开发必需品接进来。3.1 社区版够不够用别被旗舰版才完整吓到IDEA 分两个版本社区版Community完全免费旗舰版Ultimate是付费的。很多教程一上来就让你上旗舰版其实对学习 Java 基础、写普通 Spring 项目来说社区版完全够用。社区版支持Java、Kotlin、Groovy、Maven、Gradle、Git、JUnit、基础的重构和调试。旗舰版多出来的是Spring/Spring Boot 深度支持、JPA、Web 前端框架、数据库工具、远程开发等企业级功能。如果你只是学语法、写算法、做普通后端练手项目社区版闭眼用。它的下载入口在 IDEA 官网的下载页选 Community 版本就行别看错到旗舰版那个有 30 天试用但到期后功能受限。真想用旗舰版学生和教师可以申请免费的教育授权这是官方正规渠道符合要求的话很划算。搜索时搜intellij idea 社区版下载能直达官网首页的下载按钮默认可能是旗舰版要手动切到社区版。3.2 安装过程里的几个选项勾对省事下载的是.exeWindows双击后一路下一步。中途会有几个复选框我说下我的选择Create Desktop Shortcut勾上桌面图标方便。Update PATH Variable勾上能在命令行用idea命令可选无所谓。Update Context Menu勾上Open Folder as Project右键菜单方便。Create Associations勾上把.java文件关联到 IDEA。安装路径同样建议不带空格比如C:\dev\idea。原因和 JDK 一样避免老工具链解析问题。装完第一次启动会问你导入配置还是一路 next。新机器选 Do not import settings然后会让你选主题Darcula 暗色 / Light 亮色选你顺眼的。再后面就是授权页面社区版是无偿使用的直接确认即可。3.3 首次启动必做的五个设置装完别急着写代码先把这几个设置调好能省掉后面一堆麻烦。打开Settings快捷键CtrlAltS依次做改内存Help → Change Memory Settings把堆内存调到 2048 或更高。默认值在大型项目下会卡调到 2G 起步。文件编码统一Editor → File Encodings把 Global 和 Project Encoding 都设成UTF-8还有下面那个 BOM for new UTF-8 files 选 with No BOM。乱码问题基本都是这里没设对。自动保存相关IDEA 默认是自动保存的但有个保存时格式化的选项Tools → Actions on Save里按需勾。字体和字号Editor → Font把字号调到 14 或 16默认的字号看久了眼睛累。关闭自动更新Appearance Behavior → System Settings → Updates把自动检查更新关掉。开发时突然弹更新提示挺烦的想更新手动点就行。这几步花不了五分钟但直接影响后续开发体验。尤其是编码那步我见过项目里中文注释变问号的百分之九十是编码没统一。注意编码问题不只是 IDEA 里设编译时也要指定。如果你用 Maven在pom.xml里加propertiesproject.build.sourceEncodingUTF-8/project.build.sourceEncoding/properties双保险。3.4 把 JDK、Git、Maven 接进 IDEAIDEA 不是独立干活的它要调用外部工具。Settings里这几处要配JDKBuild, Execution, Deployment → Compiler → Java Compiler能看到项目用的 JDK。更直接的是File → Project Structure → Project在这里设置 Project SDK 和 Language Level。点 Add SDK → JDK选你 JDK 的根目录IDEA 会自动识别版本。如果你用脚本切了系统 JAVA_HOMEIDEA 里最好按项目显式指定 JDK这样项目之间互不干扰。GitVersion Control → GitIDEA 一般能自动检测到git.exe。检测不到就手动指定路径Windows 上通常是C:\Program Files\Git\cmd\git.exe。配好后测试一下能显示 Git 版本就成功。MavenBuild, Execution, Deployment → Build Tools → Maven指定 Maven 的安装目录和本地仓库位置。嫌麻烦可以直接用 IDEA 自带的 Bundled Maven学习阶段完全够。要自己装 Maven 的话记得也配一下本地仓库路径settings.xml里的localRepository和国内镜像不然拉依赖会慢到你想砸电脑。国内镜像怎么配在 Maven 的conf/settings.xml里找到mirrors标签加一段阿里云镜像mirror idaliyunmaven/id mirrorOf*/mirrorOf namealiyun maven/name urlhttps://maven.aliyun.com/repository/public/url /mirror这一步配好依赖下载速度能从几分钟变几秒。4. 踩坑实录那些让你怀疑人生的问题前面都是顺利路径但真实装环境的过程很少顺利。这一节我把这些年遇到的和帮别人排查过的高频问题整理出来按现象分类给你排查思路。4.1 java 不是内部或外部命令到底错在哪这是最高频的报错没有之一。现象是配完环境变量敲java -version提示找不到命令。原因无非这几种第一PATH 没配或者配错。检查 Path 里是不是有%JAVA_HOME%\bin别只配了 JAVA_HOME 忘了 PATH。第二JAVA_HOME 路径带 bin。写成...\jdk-17\bin了导致实际拼出来是...\bin\bin当然找不到。第三没开新窗口。环境变量改了但命令行是旧的读的还是旧值。第四PATH 里顺序问题。如果 PATH 里同时有多个 java 路径系统用第一个找到的。如果你之前装过旧 JDK 配过 Path可能用的是旧的。排查方法命令行敲echo %JAVA_HOME%和where java。前者看 JAVA_HOME 对不对后者列出系统找到的所有 java 可执行文件的位置。对照一下问题一目了然。提示Windows 的where java比java -version更有用它直接告诉你系统在哪些路径找到了 java排查路径冲突特别快。4.2 IDEA 识别不到 JDK或者编译版本对不上现象打开项目代码一片红提示找不到java.lang、找不到 JDK。或者编译时提示不支持发行版本 17之类。找不到 JDKFile → Project Structure → Project看 SDK 那一栏是不是空的或者红色的。点Add SDK → JDK重新指到你的 JDK 根目录。如果列表里有但你选了还是红检查下Platform Settings → SDKs里那个 JDK 的路径是不是失效了比如 JDK 被卸载或移动了。编译版本对不上这通常发生在 IDEA 用了一个 JDK但你代码里用了更高版本的语法。检查三个地方Project Structure → Project的 Language Level、Compiler → Java Compiler的 target bytecode version、还有 Mavenpom.xml里的maven.compiler.source/target。这三处必须一致任何一处低了都会报不支持发行版本。有个典型场景项目用 JDK 17但pom.xml里还写着编译级别 8结果用 17 的语法就报错。改 pom 里的属性到 17 就好。4.3 乱码、卡顿、索引重建这些玄学问题的成因控制台中文乱码IDEA 控制台默认编码和系统编码不一致导致。解决Settings → Editor → File Encodings全设 UTF-8然后在运行配置的 VM options 里加-Dfile.encodingUTF-8。Windows 系统本身的命令行编码是 GBK这也是为什么很多人在命令行跑 java 输出中文乱码——可以用chcp 65001把命令行切到 UTF-8。IDEA 卡顿、无响应第一反应是加内存前面讲的 Change Memory Settings。如果还卡检查是不是开了太多项目或者索引出了问题。File → Invalidate Caches / Restart清缓存重启大部分索引问题能解决。大型项目首次打开会建索引进度条在右下角建索引期间卡是正常的等它建完。修改代码不生效检查是不是没保存虽然 IDEA 自动保存或者运行的还是旧的 class。Clean 一下重新 Build。4.4 常见问题速查表把上面这些整理成一张表出问题时对着查比满网搜快得多。现象可能原因快速排查java 不是内部命令PATH 没配 / 未开新窗口where java 重开窗口java 版本不对PATH 里旧路径优先echo %JAVA_HOME%对照IDEA 找不到 JDKSDK 路径失效Project Structure 重设不支持发行版本编译级别不一致查 Project/SDK/pom 三处控制台中文乱码编码不一致设 UTF-8 VM optionsIDEA 卡顿内存不足 / 索引加内存 清缓存Maven 拉依赖慢没配国内镜像settings.xml 加镜像Git 不识别路径未配置手动指定 git.exe 路径这张表建议截图存下来重装系统时特别有用。5. 装完之后让环境真正能跑起来环境装好只是第一步能不能跑通项目、用起来顺手还得再走几步。这一节讲第一个项目怎么跑通、怎么把配置备份下来重装系统时能救命、以及一些实用的插件和学习建议。5.1 用第一个 Hello World 验证整条链路IDEA 里File → New → Project选 Java注意看 SDK 那一栏是不是自动选中了你装的 JDK 17。如果是空的手动选。然后 Next填项目名比如hello-jdk17Finish。建好后在src下新建一个类写public class Hello { public static void main(String[] args) { System.out.println(JDK: System.getProperty(java.version)); System.out.println(你好世界); } }右键运行。如果控制台输出JDK: 17.x.x和中文你好世界说明JDK、IDEA、编码整条链路全通了。中文没乱码说明编码配置也对。这一小步其实验证了很多东西我每次都这么测。如果中文乱码了回到 4.3 那节检查编码设置。5.2 配置备份重装系统时的救命稻草IDEA 的配置主题、快捷键、插件、设置可以导出备份。File → Manage IDE Settings → Export Settings会打成一个 zip。装新机器时用Import Settings导回去能省掉重新配置的所有时间。更省心的是用Settings Sync登录账号后配置自动同步到云端换机器自动拉。不过这需要账号看你需求。我个人习惯是定期手动导出配置包存到网盘。这个习惯救过我好几次——有次笔记本硬盘坏了重装系统后十分钟恢复全套开发环境。还有个小技巧把常用的 JDK、Maven 路径、settings.xml、常用脚本比如前面的 JDK 切换脚本一起打包备份。这些东西重装时最麻烦提前存好恢复起来就是复制粘贴的事。5.3 几个提升效率的免费插件和后续方向社区版虽然功能少一些但插件能补回来不少。这几个我一直在用Chinese (Simplified) Language Pack官方中文语言包英文不熟的话很友好。Rainbow Brackets括号配对颜色区分嵌套深的时候特别实用。Key Promoter X你用鼠标点操作时它提示你对应的快捷键帮你养成用键盘的习惯。SonarLint静态代码检查提前发现潜在 bug 和坏味道新手学规范很有帮助。装插件在Settings → Plugins里搜注意看兼容的 IDEA 版本。再往后走你会遇到 Git 配置git config --global user.name/user.email这些基础配置一定要设、Maven/Gradle 依赖管理、数据库工具本地装个 MySQL 配个图形客户端就够入门、以及按项目切换 JDK 的实战场景。这些不用一次装完用到再装避免一开始就被一堆工具压垮。我个人带新人的经验是先把 JDK IDEA 一个能跑的 Hello World 搞定剩下的边做边学。一上来就想把 Git、Maven、MySQL、Redis 全配齐往往每个都配得半吊子出了问题还不知道是谁的锅。环境这东西够用就好别追求一步到位。踩过几次坑之后你会发现真正难的不是安装本身而是遇到报错时知道去哪里看、怎么定位——where java、echo %JAVA_HOME%、IDEA 的Invalidate Caches这几个命令和操作记住能解决八成的环境问题。