Maven 项目导入导出

Maven 项目通过 IDE 插件导入，生成 IDE 项目文件同步配置。

项目导入

IDEA 导入

File → Open → 选择项目目录（含 pom.xml）
IDEA 自动识别为 Maven 项目

Eclipse 导入

File → Import → Maven → Existing Maven Projects
选择项目根目录 → Finish

VS Code 导入

打开项目目录 → 安装 Java Extension Pack
自动检测 pom.xml → 导入 Maven 项目

生成 IDE 项目文件

使用 maven-eclipse-plugin

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-eclipse-plugin</artifactId>
  <version>2.10</version>
  <configuration>
    <downloadSources>true</downloadSources>
    <downloadJavadocs>true</downloadJavadocs>
    <wtpversion>2.0</wtpversion>
  </configuration>
</plugin>

执行命令

mvn eclipse:eclipse

生成的文件

.project        # Eclipse 项目文件
.classpath      # Eclipse 类路径文件
.settings/      # Eclipse 设置目录

清除 Eclipse 文件

mvn eclipse:clean

IDEA 项目文件

IDEA 不需要生成

IDEA 直接读取 pom.xml，无需生成项目文件。

配置存储位置

.idea/
├── modules.xml
├── workspace.xml
└── misc.xml

不提交版本库

.idea/ 通常加入 .gitignore

导入后配置同步

自动同步内容

pom.xml 修改后

IDEA/Eclipse 自动检测变更并同步。

项目导出场景

导出源码

# 导出包含 pom.xml 的源码
git clone 项目地址

导出构件

mvn package
# target/*.jar

发布到仓库

mvn deploy
# 其他项目可引用

多模块项目导入

IDEA 导入

打开父 POM 目录
自动识别所有子模块

Eclipse 导入

Import → Maven → Existing Maven Projects
选择父 POM 目录
勾选所有模块 → Finish

跨 IDE 兼容

共同配置源

pom.xml 是配置唯一来源：

IDEA/Eclipse/VS Code 均读取 pom.xml
修改 pom.xml → 所有 IDE 同步

不兼容项

导入验证

检查导入成功

1. 源码目录正确识别
2. 依赖全部下载
3. JDK 版本匹配
4. 项目可编译

排查问题

# IDEA刷新
右键 pom.xml → Maven → Reload Project

# Eclipse更新
右键项目 → Maven → Update Project

项目结构一致性

Maven 约定优先

pom.xml 定义的目录结构
IDE 忠实反映 Maven 配置
不从 IDE 修改目录设置

目录配置源

<build>
  <sourceDirectory>src/main/java</sourceDirectory>
  <testSourceDirectory>src/test/java</testSourceDirectory>
</build>

IDE 自动读取并配置。

要点总结

• IDEA/Eclipse 直接导入 pom.xml 目录
• maven-eclipse-plugin 可生成 Eclipse 文件
• pom.xml 是配置唯一来源
• IDE 配置文件不提交版本库
• 修改 pom.xml 后 IDE 自动同步
• 多模块项目打开父目录导入