选错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免费学习笔记（深入）”；
Java 接口排错助手
下载
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
- 新建项目时，在左侧选择
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中的<build><sourcedirectory></sourcedirectory></build>配置
运行时提示 “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 的运行上下文没对齐。
