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.javaUnsupported class file major version 这类错误上。

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

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

  • 下载地址认准官方:https://www./link/e387385ebe0dbeefed3e8e9f3968aaba(选 Eclipse Temurin JDK 17,Windows选msi,macOS选pkg
  • 安装后验证:
    java -version
    输出应含 17.0.x,不是 1.8.021.0.x
  • 不需要手动配JAVA_HOME(现代安装包默认写入系统变量),除非java -version报错或显示错版本

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

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

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

常见坑:

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

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

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

  • 在项目根目录新建pom.xml,内容极简即可:
    
    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

事情说清了就结束。