技术 2025-08-26 阅读: 46

Eclipse 创建 java Maven project 教程

Eclipse 创建 java Maven project 教程

前提条件

  1. 已安装 Eclipse IDE(建议使用 Eclipse IDE for Java Developers 版本)

  2. Eclipse 中已集成 Maven 插件(现代版本的 Eclipse 通常默认包含)

步骤 1:打开 Eclipse 并创建新项目

  1. 启动 Eclipse,进入工作空间(Workspace)

  2. 在菜单栏选择 File > New > Project...

  3. 在弹出的对话框中,展开 Maven 文件夹,选择 Maven Project,然后点击 Next

步骤 2:配置 Maven 项目基本设置

  1. New Maven Project 窗口中,保持默认的 Create a simple project (skip archetype selection) 未勾选(如果是初学者,建议不勾选)

  2. 点击 Next 进入 archetype 选择界面

步骤 3:选择 Maven Archetype

  1. Archetype 列表中,选择合适的 archetype:
  • 对于普通 Java 项目,推荐选择 maven-archetype-quickstart

  • 在搜索框输入 quickstart 可快速筛选

  1. 选择最新版本的 archetype(通常是列表中靠上的版本)

  2. 点击 Next

步骤 4:设置项目坐标(GroupId, ArtifactId, Version)

  1. Group Id 中输入组织 / 公司的反向域名(例如:com.example

  2. Artifact Id 中输入项目名称(例如:my-first-maven-project

  3. Version 保持默认的 0.0.1-SNAPSHOT 即可

  4. Package 会根据 GroupId 和 ArtifactId 自动生成,也可手动修改(例如:com.example.myproject

  5. 点击 Finish 完成项目创建

步骤 5:查看创建的 Maven 项目结构

创建完成后,项目结构如下:

my-first-maven-project/

├── src/

│   ├── main/

│   │   └── java/          // 主程序代码目录

│   │       └── com/

│   │           └── example/

│   │               └── myproject/

│   │                   └── App.java  // 主类

│   └── test/

│       └── java/          // 测试代码目录

│           └── com/

│               └── example/

│                   └── myproject/

│                       └── AppTest.java  // 测试类

├── pom.xml                // Maven 项目核心配置文件

└── target/                // 编译输出目录(自动生成)

步骤 6:理解并修改 pom.xml

pom.xml 是 Maven 项目的核心配置文件,包含项目依赖、插件、构建配置等:

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"​
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">​
  <modelVersion>4.0.0</modelVersion>​
​
  <groupId>com.example</groupId>​
  <artifactId>my-first-maven-project</artifactId>​
  <version>0.0.1-SNAPSHOT</version>​
  <name>my-first-maven-project</name>​
  <url>http://maven.apache.org</url>​
​
  <properties>​
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>​
    <maven.compiler.source>1.8</maven.compiler.source> <!-- Java 版本 -->​
    <maven.compiler.target>1.8</maven.compiler.target>​
  </properties>​
​
  <dependencies>​
    <!-- 添加项目依赖 -->​
    <dependency>​
      <groupId>junit</groupId>​
      <artifactId>junit</artifactId>​
      <version>4.12</version>​
      <scope>test</scope> <!-- 测试范围依赖 -->​
    </dependency>​
  </dependencies>​
</project>

步骤 7:运行 Maven 项目

  1. 右键点击项目,选择 Run As > Maven build...

  2. Goals 中输入 clean package(清理并打包项目)

  3. 点击 Run,Maven 会自动下载依赖并编译打包项目

  4. 打包完成后,可在 target 目录下找到生成的 JAR 文件

步骤 8:运行 Java 应用程序

  1. 找到 src/main/java 下的主类(如 App.java

  2. 右键点击该类,选择 Run As > Java Application

  3. 在控制台(Console)中查看程序输出

常见问题解决

  • 如果 Eclipse 中没有 Maven 选项,可通过 Help > Eclipse Marketplace 搜索 Maven 并安装 Maven Integration for Eclipse

  • 依赖下载缓慢可配置国内 Maven 镜像(修改 settings.xml 文件)

  • 项目报错可尝试右键项目选择 Maven > Update Project... 更新项目

通过以上步骤,你已经成功创建并运行了一个 Eclipse Maven 项目。Maven 的主要优势在于依赖管理和项目构建自动化,适合管理中小型到大型的 Java 项目。

标签:

分享本文:

链接已复制到剪贴板