Java初学者如何快速完成开发环境搭建

初学者应选用JDK 17（LTS）+ IntelliJ IDEA Community版，5分钟内可运行HelloWorld；避免JDK 8（过旧）和JDK 21（兼容问题多），安装后验证java -version，IDE自动识别SDK并支持一键运行，配合pom.xml启用Maven管理依赖。

Java初学者如何快速完成开发环境搭建

直接说结论：别装JDK 21或22，用JDK 17（LTS）+ IntelliJ IDEA Community版，5分钟内能跑出第一个 HelloWorld。新版本JDK自带太多预览特性、模块系统约束和IDE兼容问题，初学阶段反而卡在 module-info.java 或 Unsupported class file major version 这类错误上。

为什么选JDK 17而不是JDK 8或JDK 21

JDK 8 太老，缺少现代化语法（如var、switch表达式）、工具链支持弱，很多教程和依赖已默认要求JDK 11+；
JDK 21 虽是新LTS，但部分插件（如旧版Maven Surefire、某些Gradle插件）尚未完全适配，且--enable-preview相关报错会让新手误以为“环境坏了”；
JDK 17 是当前最稳的LTS，主流IDE、构建工具、Spring Boot 3.x（初学推荐从spring-boot-starter-web起步）都开箱即用。

• 下载地址认准官方：https://www.php.cn/link/e387385ebe0dbeefed3e8e9f3968aaba（选 Eclipse Temurin JDK 17，Windows选msi，macOS选pkg）
• 安装后验证：

  java -version

  输出应含 17.0.x，不是 1.8.0 或 21.0.x
• 不需要手动配JAVA_HOME（现代安装包默认写入系统变量），除非java -version报错或显示错版本

IntelliJ IDEA比Eclipse或VS Code更省事的原因

初学阶段最怕“写完代码不知道怎么运行”。IntelliJ对Java项目结构感知强，新建Java Class后点绿色三角就能直接运行，不用手写javac/java命令，也不用纠结classpath路径。

• 下载IntelliJ IDEA Community（免费，足够学完Spring Boot前的所有内容）
• 新建项目时选 Java → Next → Project SDK 确认是17（若没出现，点New...指向JDK 17安装目录）
• 创建类时，右键src → New → Java Class，输入HelloWorld，IDE自动补全public static void main(String[] args)
• 光标放main方法内，按Ctrl+Shift+F10（Win/Linux）或Ctrl+R（macOS）直接运行

常见坑：

立即学习“Java免费学习笔记（深入）”；

PaperFake

AI写论文

下载

• 如果点运行没反应，检查右上角是否选中了正确的Run Configuration（名字应为HelloWorld，不是Unnamed）
• 若提示Cannot resolve symbol 'System'，说明SDK没绑定成功，回到File → Project Structure → Project重新选JDK 17

跳过Maven/Gradle也能写Java，但建议立刻加一个pom.xml

不装构建工具也能编译运行单文件，但一旦想用Scanner读输入、或下一步学Web，就会掉进ClassNotFoundException或NoClassDefFoundError坑里——因为标准库之外的类（比如org.apache.commons.lang3.StringUtils）必须靠Maven下载。

• 在项目根目录新建pom.xml，内容极简即可：

  
  https://www.php.cn/link/8eecb5252905f8dcf307a09d6fb6745f"
  xmlns:xsi="https://www.php.cn/link/1fb425070298bc615c24b69845387662"
  xsi:schemaLocation="https://www.php.cn/link/8eecb5252905f8dcf307a09d6fb6745fhttp://maven.apache.org/xsd/maven-4.0.0.xsd">;
  4.0.0
  com.example
  hello-java
  1.0-SNAPSHOT
  
  17
  
  

• 保存后，IntelliJ右下角会弹出Import changes，点它，Maven自动下载本地仓库并识别为项目
• 后续加依赖（比如学集合时想用Guava），只在pom.xml里加块，IDE自动拉取，不用手动下jar、拖lib、设Build Path

真正容易被忽略的点：

• Windows用户如果用PowerShell运行mvn命令失败，别折腾环境变量，直接在IntelliJ内置Terminal里执行（它自动继承IDE配置）
• pom.xml里必须和实际JDK一致，否则Maven编译器插件可能默认用JDK 11生成字节码，导致运行时报Unsupported major.minor version

事情说清了就结束。