首页 > 文章 > java教程

Java项目结构搭建指南

时间：2025-11-27 23:56:57 501浏览收藏

知识点掌握了，还需要不断练习才能熟练运用。下面golang学习网给大家带来一个文章开发实战，手把手教大家学习《Java项目结构怎么搭建》，在实现功能的过程中也带大家重新温习相关知识点，温故而知新，回头看看说不定又有不一样的感悟！

标准Java项目结构遵循Maven布局，包含src/main/java和src/test/java目录，通过pom.xml管理依赖，使用mvn命令编译、测试和打包，提升项目可维护性与自动化能力。

在Java中如何创建标准Java项目结构

在Java中创建标准项目结构，主要是遵循Maven或Gradle等构建工具推荐的目录布局。这种结构有助于代码组织、测试分离和构建自动化。以下是手动创建一个标准Java项目结构的方法，以Maven风格为例。

1. 标准项目目录结构

一个典型的Java项目结构如下：

my-java-project/
├── src/
│   ├── main/
│   │   └── java/
│   │       └── com/example/App.java
│   └── test/
│       └── java/
│           └── com/example/AppTest.java
├── pom.xml (如果是Maven项目)
└── README.md

说明：

src/main/java：存放主源代码
src/test/java：存放测试代码（如JUnit测试）
pom.xml：Maven配置文件，定义依赖、插件和项目信息

2. 创建目录结构

可以在命令行中使用以下命令创建目录：

mkdir -p my-java-project/src/main/java/com/example
mkdir -p my-java-project/src/test/java/com/example

然后在对应位置创建Java文件。

3. 编写主类 App.java

在 src/main/java/com/example/App.java 中写入：

package com.example;

public class App {
    public static void main(String[] args) {
        System.out.println("Hello, Standard Java Project!");
    }
}

4. 添加测试类（可选）

在 src/test/java/com/example/AppTest.java 中添加测试：

package com.example;

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

class AppTest {
    @Test
    void testMain() {
        // 简单测试，不报错即可
        assertDoesNotThrow(() -> App.main(new String[]{}));
    }
}

5. 使用 Maven 初始化项目

进入项目根目录，运行：

mvn archetype:generate -DgroupId=com.example \
    -DartifactId=my-java-project \
    -DarchetypeArtifactId=maven-archetype-quickstart \
    -DinteractiveMode=false

这会自动生成标准结构和基础pom.xml。

或者手动创建 pom.xml 文件：

    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  4.0.0
  com.example
  my-java-project
  1.0-SNAPSHOT

    11
    11



      org.junit.jupiter
      junit-jupiter
      5.8.1
      test





        org.apache.maven.plugins
        maven-surefire-plugin
        3.0.0-M7

6. 编译与运行

使用Maven进行构建：

mvn compile # 编译主代码
mvn test # 运行测试
mvn package # 打包成 JAR（如果配置了mainClass）

直接运行主类：

java -cp target/classes com.example.App

基本上就这些。标准结构让项目更易维护，也方便集成CI/CD和IDE识别。

好了，本文到此结束，带大家了解了《Java项目结构搭建指南》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！

maven 项目管理目录结构 pom.xml Java项目结构