必须手动配置Maven路径并导入pom.xml：在All Settings中设置Maven home path为本地安装目录（如D:\DevTools\apache-maven-3.9.6），指定settings.xml，勾选自动导入；用File→New→Project from Existing Sources按向导导入，确保识别parent及子模块；编辑pom.xml后点Import Changes，或通过Maven工具窗口添加/排除依赖；最后验证import成功、dependency:tree输出正确且Dependencies节点无报错。
要在IntelliJ IDEA中稳定运行Spring Boot或微服务项目，必须让IDEA正确识别Maven的pom.xml结构、自动下载依赖并执行clean/compile/package等生命周期命令，否则连基本的类导入都会报红。
配置Maven全局环境
打开IDEA欢迎界面 → 点击 Customize → All Settings（不要在已有项目中设置，否则只生效于当前工程）。
在搜索框输入 Maven → 进入 Build Tools → Maven 页面。
【Maven home path必须指向你手动安装的Maven目录，不能用Bundled（自带）版本】。比如填入 D:\DevTools\apache-maven-3.9.6（路径中不能含中文、空格或括号）。
点击右侧 … 按钮，定位到你Maven安装目录下的 conf\settings.xml，填入 User settings file 栏位。这一步决定镜像源、本地仓库位置和代理是否生效。
勾选 Import Maven projects automatically 和 Always update snapshots，避免手动点刷新才能拉新快照依赖。
从pom.xml导入已有Maven项目
不要用 File → Open 直接打开项目文件夹——IDEA会把它当普通文件夹处理，不解析依赖、不识别模块、不激活Maven工具窗口。
正确做法是：File → New → Project from Existing Sources → 选中项目根目录 → 点击OK → 在弹出的向导中务必勾选“Import project from external model” → 选择Maven → 下一步。
IDEA会自动扫描根目录下的pom.xml，并递归识别所有<module>声明的子模块。如果项目含parent POM，这一步能确保继承关系和dependencyManagement被完整加载。
导入完成后，右下角会出现 Importing 'xxx' project 提示，等待Maven工具窗口底部进度条走完，且Dependencies节点展开无红色感叹号才算成功。
添加与排除依赖
方法一：直接编辑pom.xml
在 <dependencies> 标签内插入标准坐标，例如：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<version>3.3.2</version>
</dependency>
写完后，pom.xml编辑器上方会弹出黄色提示条 → 点击 Import Changes（不是右上角的刷新图标），触发Maven重载和依赖下载。
方法二：通过Maven工具窗口快捷添加
右侧边栏打开 Maven 工具窗口 → 展开当前项目 → 点击 Dependencies → 点击 + Add Dependency → 输入关键词如 lombok → 从搜索结果中选中 → 点击OK → 自动写入pom.xml并触发Import Changes。
方法三：排除传递依赖（防冲突）
当你引入某个starter却因内部依赖版本打架导致启动失败，比如spring-boot-starter-data-jpa自动带了hibernate-core 6.5.x，但你要用6.4.x，就得排除它：
在对应dependency标签内加入<exclusions>块：
<exclusions>
<exclusion>
<groupId>org.hibernate</groupId>
<artifactId>hibernate-core</artifactId>
</exclusion>
</exclusions>
【注意：exclusion里不能写version，写了会被忽略】
验证依赖是否真正生效
第一步：打开任意Java类 → 尝试 import org.springframework.web.bind.annotation.RestController；
第二步：若无红色波浪线且能跳转到该类定义，说明spring-web依赖已成功加载；
第三步：在终端（Terminal）中执行 mvn dependency:tree -Dincludes=org.springframework → 查看控制台输出是否包含你期望的artifactId和version；
第四步：右键项目 → Maven → Reload project → 观察Maven工具窗口中Dependencies节点是否展开完整，没有灰色禁用图标或“unresolved”字样。
