在Java中如何创建初始项目目录结构

在Java开发中，规范的初始项目目录结构能让代码管理、依赖引入、打包部署都更顺畅，新手往往不知道从何下手，下面介绍几种常用的创建方式。

一、Java项目标准目录规范

不管使用什么构建工具，Java项目的核心目录结构都遵循约定，标准结构如下：

• src/main/java：存放项目核心业务代码
• src/main/resources：存放配置文件、静态资源等
• src/test/java：存放单元测试代码
• src/test/resources：存放测试用的配置文件
• pom.xml（Maven项目）或build.gradle（Gradle项目）：构建配置文件
• target（Maven）或build（Gradle）：编译打包后的输出目录

二、使用Maven创建初始目录结构

Maven是Java生态最常用的构建工具，自带项目生成命令，可以快速创建符合规范的目录结构。

1. 命令行生成项目

打开终端执行以下命令，按提示输入项目信息即可：

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

执行完成后会生成如下目录结构：

java-demo
├── pom.xml
└── src
    ├── main
    │   └── java
    │       └── com
    │           └── example
    │               └── demo
    │                   └── App.java
    └── test
        └── java
            └── com
                └── example
                    └── demo
                        └── AppTest.java

2. 手动创建Maven项目目录

如果没有安装Maven，也可以手动创建对应目录，然后编写pom.xml文件：

<?xml version="1.0" encoding="UTF-8"?>
<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.demo</groupId>
    <artifactId>java-demo</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
    </properties>
</project>

三、使用Gradle创建初始目录结构

Gradle也是常用的构建工具，生成目录结构的方式同样简单。

1. 命令行生成项目

执行以下命令创建Java项目：

gradle init --type java-application --project-name java-demo --package com.example.demo

生成的目录结构如下：

java-demo
├── build.gradle
├── settings.gradle
└── src
    ├── main
    │   ├── java
    │   │   └── com
    │   │       └── example
    │   │           └── demo
    │   │               └── App.java
    │   └── resources
    └── test
        ├── java
        │   └── com
        │       └── example
        │           └── demo
        │               └── AppTest.java
        └── resources

2. 手动创建Gradle项目目录

手动创建目录后，编写build.gradle文件即可：

plugins {
    id 'java'
}

group 'com.example.demo'
version '1.0-SNAPSHOT'

repositories {
    mavenCentral()
}

dependencies {
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.8.1'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.8.1'
}

test {
    useJUnitPlatform()
}

四、普通Java项目手动创建目录

如果不使用构建工具，也可以手动创建最基础的目录结构，适合简单的练习项目：

java-demo
├── src
│   ├── main
│   │   └── java
│   │       └── com
│   │           └── example
│   │               └── demo
│   │                   └── Main.java
│   └── test
│       └── java
│           └── com
│               └── example
│                   └── demo
│                       └── MainTest.java
└── out

对应的Main.java示例代码：

package com.example.demo;

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

五、目录结构注意事项

创建目录时需要注意以下几点：

• 包名要和目录结构对应，比如包com.example.demo对应src/main/java/com/example/demo目录
• 资源文件放在resources目录下，编译后会自动复制到classpath根目录
• 测试代码和主代码分开存放，避免打包时把测试代码带入生产环境
• 如果使用IDE（如IDEA、Eclipse），可以直接通过新建项目向导生成标准目录，不需要手动操作

Java项目目录结构初始化项目MavenGradle修改时间：2026-05-25 22:04:56