选错JDK版本需先配置SDK:确认JDK安装及JAVA_HOME正确,再在File→Project Structure→SDKs中添加JDK路径;新建项目时勾选“Create from archetype”以预置依赖模板;src目录需手动标记为Sources Root;运行前须在Run Configurations中指定Main class。

IntelliJ IDEA 新建 Maven 项目时选错 JDK 版本怎么办
新建项目时如果 Project SDK 下拉列表为空或版本过低(比如只显示 JDK 8),说明 IDEA 没有正确识别已安装的 JDK,或者你还没配置。这不是 Maven 的问题,而是 IDEA 的 SDK 管理前置条件。
解决方法很简单:
- 先去系统确认 JDK 已安装且
JAVA_HOME配置正确(终端执行java -version和$JAVA_HOME/bin/java -version) - 在 IDEA 中打开 File → Project Structure → Platform Settings → SDKs,点击
+→Add JDK,手动指向 JDK 根目录(如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home或C:\Program Files\Java\jdk-17) - 返回新建项目向导,
Project SDK就能选到了;同时建议勾选Add sample code,它会自动生成带App.java和基础pom.xml的骨架
创建时没勾选 “Create from archetype” 导致 pom.xml 缺失依赖模板
IDEA 默认新建的 Maven 项目是“空骨架”,pom.xml 只有最简结构(groupId、artifactId、version),没有 dependencies 或 build 块。这不是错误,但容易让人误以为“项目没建好”。
如果你想要 Spring Boot、JUnit 5 或 Log4j2 等常用依赖预置,必须主动启用 archetype:
立即学习“Java免费学习笔记(深入)”;
- 新建项目时,在左侧选择
Maven后,**务必勾选Create from archetype** - 然后从下拉菜单选一个常用 archetype,比如:
maven-archetype-quickstart(基础 Java 项目)、org.springframework.boot:spring-boot-starter-parent(需提前添加 Spring 官方 catalog) - 如果不慎跳过这步,后续也能补:右键项目根目录 →
Add Framework Support…→ 勾选Maven,再手动编辑pom.xml加入依赖
第一次 import Maven 项目后 src 目录没被识别为 Sources Root
即使 pom.xml 写对了,IDEA 有时也不会自动把 src/main/java 标为源码根目录,导致类名报红、main 方法无法运行。这是 Maven 与 IDEA 元数据同步不及时的典型表现。
手动标记即可修复:
- 在 Project 视图中,右键
src/main/java→Mark Directory as → Sources Root - 同理,
src/test/java标为Test Sources Root,src/main/resources标为Resources Root - 更彻底的做法:右键项目名 →
Maven → Reload project,触发 IDEA 重新读取pom.xml中的配置
运行时提示 “Error: Could not find or load main class”
这个错误和 Maven 无关,纯粹是 IDEA 运行配置没指定主类。即便 App.java 里有 public static void main(String[] args),IDEA 也不会自动发现它。
必须显式设置:
- 点击右上角运行配置下拉框 →
Edit Configurations… - 点击左上角
+→ 选择Application - 在
Main class输入框中,点击右侧...按钮,从弹出列表中选择你的启动类(如com.example.App) - 确保
Use classpath of module选的是你当前项目的 module(不是 Maven 或其他)
这个步骤漏掉一次,后面每次新建项目都得重复——很多人卡在这一步,以为是 Maven 配置失败,其实只是 IDEA 的运行上下文没对齐。










