Eclipse Maven 插件

Eclipse 使用 m2e 插件支持 Maven 项目管理。

m2e 插件

安装

现代 Eclipse 已内置 m2e 插件。

查看安装

Help → Eclipse Marketplace → Installed
搜索: Maven Integration for Eclipse

手动安装

Help → Install New Software
地址: https://download.eclipse.org/technology/m2e/releases

Maven 配置

配置位置

Window → Preferences → Maven

配置项

设置 Maven 路径

Preferences → Maven → Installations
Add → 选择 Maven 安装目录
☑ 选择刚添加的安装

导入 Maven 项目

方式

File → Import → Maven → Existing Maven Projects

步骤

1. 选择项目根目录
2. 检测 pom.xml
3. 选择要导入的项目
4. Finish 完成导入

自动同步

导入后 Eclipse 自动：

• 下载依赖
• 配置 Java 构建路径
• 设置源码目录

项目结构视图

Package Explorer

my-app/
├── src/main/java      → Java 源码
├── src/main/resources → 资源文件
├── src/test/java      → 测试源码
├── JRE System Library → JDK
├── Maven Dependencies → Maven 依赖
└── pom.xml            → POM 文件

Maven 视图

打开方式

Window → Show View → Other → Maven → Maven Repositories

功能视图

执行 Maven 命令

方式1：Run As

右键项目 → Run As → Maven build...
Goals: clean package
Run

方式2：Maven Build 视图

Maven Build 视图 → New Launch Configuration
Name: my-app-package
Goals: clean package
Base directory: ${project_loc}

快捷执行

右键项目 → Run As → Maven install
右键项目 → Run As → Maven package

依赖管理

添加依赖

pom.xml → Dependencies 标签页 → Add
搜索依赖 → 选择版本 → OK

编辑 pom.xml

<!-- 直接编辑 XML -->
<dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-core</artifactId>
  <version>5.3.20</version>
</dependency>

<!-- Ctrl+S 保存自动下载 -->

更新项目

更新依赖

右键项目 → Maven → Update Project...
☑ Force Update of Snapshots/Releases
Update

快捷键

Alt+F5 → 更新 Maven 项目

构建路径同步

检查路径

右键项目 → Properties → Java Build Path

自动同步

m2e 自动维护：

• 源码目录
• 输出目录
• Maven 依赖 JAR
• JDK 版本

生命周期映射

配置位置

Preferences → Maven → Lifecycle Mappings

自定义映射

处理插件未识别的生命周期绑定。

<lifecycleMappingMetadata>
  <pluginExecutions>
    <pluginExecution>
      <pluginExecutionFilter>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>exec-maven-plugin</artifactId>
        <versionRange>[1.0,)</versionRange>
        <goals>
          <goal>exec</goal>
        </goals>
      </pluginExecutionFilter>
      <action>
        <execute/>
      </action>
    </pluginExecution>
  </pluginExecutions>
</lifecycleMappingMetadata>

常见问题

插件执行忽略

错误: Plugin execution not covered by lifecycle configuration

解决:
Preferences → Maven → Errors/Warnings
Plugin execution not covered → Ignore

依赖下载失败

解决:
右键项目 → Maven → Update Project
☑ Force Update
☑ Update Dependencies

编译版本不匹配

解决:
pom.xml → Overview 标签页
Properties → maven.compiler.source/target

要点总结

• m2e 插件已内置在现代 Eclipse
• Import → Maven → Existing Maven Projects 导入项目
• Preferences → Maven 配置安装路径和 settings.xml
• 右键 → Run As → Maven build 执行命令
• Maven → Update Project 更新依赖
• Alt+F5 快捷更新 Maven 项目