必须严格遵循maven标准目录结构与idea元数据逻辑：①新建项目时选maven-archetype-quickstart并勾选add sample code；②确保pom.xml存在且语法正确，右键add as maven project；③通过pom.xml或maven工具栏添加依赖后点击import changes；④统一project sdk、maven jdk及自动导入设置。
要在IntelliJ IDEA中从零开始搭建一个可编译、可运行的Maven项目，并确保第三方库能被正确识别和使用，必须严格遵循Maven的标准目录结构与IDEA的项目元数据生成逻辑，否则会出现“package不存在”“ClassNotFoundException”或依赖不生效等问题。
创建标准Maven项目骨架
启动IntelliJ IDEA → 新建Project → 左侧选择 【Maven】 → 右侧勾选 “Create from archetype” → 在下方列表中选中 maven-archetype-quickstart（这是最精简可靠的Java基础骨架）→ 点击Next。
填写GroupId（如com.example）、ArtifactId（如my-app）、Version（默认1.0-SNAPSHOT即可）→ 点击Next → 设置项目名称和存储路径 → 确保勾选 “Add sample code” → 点击Finish。
这一步会自动生成src/main/java、src/test/java等标准目录。如果跳过archetype直接选“Empty project”，后续需手动补全目录结构且IDEA不会自动识别为Maven模块，极易导致依赖无法加载。
手动启用Maven支持（适用于已存在但未识别的项目）
若打开的是已有pom.xml但IDEA未识别为Maven项目：右键点击pom.xml文件 → 选择 “Add as Maven Project”。
注意：【必须在项目根目录下存在pom.xml，且文件内容语法正确】，否则会弹出“Cannot resolve symbol”错误且无法恢复，此时需检查XML格式是否闭合、schema声明是否缺失。
添加并验证依赖
方法一：通过pom.xml手动编辑
在pom.xml的<dependencies></dependencies>标签内插入一段依赖声明，例如JUnit 5：
保存文件后，IDEA右下角会弹出“Import changes”提示 → 点击它，等待Maven自动下载jar包并刷新项目结构。
方法二：使用IDEA内置依赖搜索
点击右侧Maven工具栏（通常在右边缘）→ 展开项目名 → 点击“+”号按钮 → 输入关键词如“lombok” → 从搜索结果中选中对应条目 → 点击“Add” → IDEA会自动写入pom.xml并触发导入。
验证依赖是否生效：打开src/test/java下的AppTest.java → 尝试输入@Test → 如果出现import提示且无红色波浪线，说明JUnit已成功加载。
配置JDK与Maven版本一致性
第一步：打开File → Project Structure → Project → 确认Project SDK设置为已安装的JDK（如JDK 17），Project language level同步匹配。
第二步：进入Settings → Build, Execution, Deployment → Build Tools → Maven → 检查Maven home path指向本地解压后的Maven 3.8.6+目录，而非IDEA内置的“Bundled (Maven 3.x)”——后者常因缓存机制导致依赖解析失败或离线构建异常。
第三步：回到Maven → Importing → 勾选“Import Maven projects automatically”，并确认“JDK for importer”与Project SDK一致 → 点击OK。
这三步缺一不可。若Maven用JDK 8而项目设为JDK 17，编译时会报“Unsupported class file major version”；若未勾选自动导入，新增依赖后需手动点击“Reload project”图标，否则代码里仍无法调用新库。
