IDEA Maven 集成
IntelliJ IDEA 内置 Maven 支持，提供完整的项目管理能力。
Maven 配置
设置路径
XML
File → Settings → Build, Execution, Deployment → Build Tools → Maven
配置项
| 配置 | 说明 |
|---|---|
| Maven home path | Maven 安装目录 |
| User settings file | settings.xml 路径 |
| Local repository | 本地仓库路径 |
配置界面
Bash
Maven home path: D:\apache-maven-3.9.6
User settings file: C:\Users\用户\.m2\settings.xml
Local repository: C:\Users\用户\.m2\repository
导入 Maven 项目
方式
- 打开包含 pom.xml 的目录
- File → Open → 选择项目目录
- File → New → Project from Existing Sources
自动导入
IDEA 检测到 pom.xml 后自动识别为 Maven 项目。
手动刷新
text
右键 pom.xml → Maven → Reload Project
自动导入设置
配置位置
text
Settings → Build Tools → Maven → Importing
关键设置
| 设置 | 说明 |
|---|---|
| Import Maven projects automatically | 自动导入变更 |
| Automatically download | 自动下载源码/文档 |
| JDK for importer | 导入时使用的 JDK |
推荐配置
text
☑ Import Maven projects automatically
☑ Download sources
☑ Download documentation
Sources JDK: 17
Maven 工具窗口
打开方式
text
View → Tool Windows → Maven
功能
| 功能 | 说明 |
|---|---|
| Projects | 项目结构树 |
| Lifecycle | 生命周期阶段 |
| Plugins | 插件列表 |
| Dependencies | 依赖树 |
执行命令
双击生命周期阶段或右键选择执行。
依赖管理
添加依赖
text
<!-- 编辑 pom.xml -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>5.3.20</version>
</dependency>
<!-- IDEA 自动导入 -->
搜索依赖
text
pom.xml → Alt+Insert → Add Dependency
搜索并添加 Maven Central 依赖。
依赖范围查看
text
Maven 窗口 → Dependencies
展开查看传递依赖树。
快捷操作
常用快捷键
| 快捷键 | 功能 |
|---|---|
| Ctrl+Shift+O | 刷新 Maven 项目 |
| Ctrl+N | 快速执行 mvn 命令 |
| Alt+Insert | 添加依赖 |
快速执行
text
Maven 窗口 → Lifecycle → 双击 package
Maven Runner 配置
配置位置
text
Settings → Build Tools → Maven → Runner
配置项
| 设置 | 说明 |
|---|---|
| VM Options | JVM 参数 |
| JRE | 运行时 JDK |
| Delegate IDE build | IDE 构建委托 Maven |
示例 VM Options
text
-Xmx512m -XX:+HeapDumpOnOutOfMemoryError
Profile 选择
配置位置
text
Maven 窗口 → Profiles
勾选要激活的 Profile。
编译配置
Delegate IDE build
text
Settings → Build, Execution, Deployment → Build Tools → Maven → Runner
☑ Delegate IDE build/run actions to Maven
IDE 构建操作委托给 Maven 执行。
遇到的问题
依赖未下载
解决方法：
text
# 强制刷新
mvn dependency:resolve -U
# IDEA刷新
Maven窗口 → 右键 → Reload All Maven Projects
索引更新慢
text
Settings → Maven → Repositories
右键仓库 → Update
版本冲突显示
text
pom.xml 中依赖红色波浪线标记冲突
Alt+Enter → 查看冲突详情
要点总结
- IDEA 内置 Maven，配置 Maven home 和 settings.xml
- 启用 Import automatically 自动导入依赖变更
- Maven 窗口提供生命周期、依赖管理
- Alt+Insert 快速添加依赖
- Ctrl+Shift+O 刷新 Maven 项目
- Delegate IDE build 委托 Maven 构建
