使用 Idea2025 创建 Maven 项目时为何不生成 src 目录？

Question

在使用 IntelliJ IDEA 2025 创建 Maven 项目时，部分开发者发现项目结构中未自动生成 `src` 目录。这通常是因为在项目初始化过程中未正确选择模板或未配置好 `archetype`。IDEA 2025 若未选择“Create from archetype”或选择了错误的 archetype（如 `maven-archetype-site`），则不会生成标准的源码目录结构。此外，手动创建项目时若未勾选“Generate from archetype”选项，也可能导致 `src` 缺失。解决方法包括：选择合适的 archetype（如 `maven-archetype-quickstart`）、检查项目类型是否为标准 Maven 项目，或手动补全目录结构并配置 `pom.xml`。

Answer 1

一、问题现象：IntelliJ IDEA 2025 创建 Maven 项目未生成 src 目录

部分开发者在使用 IntelliJ IDEA 2025 创建 Maven 项目时，发现项目结构中没有自动生成标准的 src 目录，导致后续开发工作无法顺利进行。

• src/main/java：存放 Java 源代码
• src/main/resources：存放资源文件
• src/test/java：存放测试代码

二、问题成因分析

该问题通常出现在项目初始化阶段，主要原因包括：

1. 未选择“Create from archetype”选项
2. 选择了错误的 archetype，如 maven-archetype-site
3. 手动创建项目时未勾选“Generate from archetype”
4. 项目类型未正确设置为 Maven 项目

原因	影响
未选择 archetype	不会生成标准目录结构
错误的 archetype	生成非标准结构或仅文档结构
未正确配置项目类型	IDE 不识别为 Maven 项目

三、解决方案详解

针对上述问题，开发者可通过以下方式进行修复或预防：

1. 选择合适的 Archetype

推荐使用 maven-archetype-quickstart，这是最常用的 Java 项目模板。

<groupId>org.apache.maven.archetypes</groupId>
<artifactId>maven-archetype-quickstart</artifactId>
<version>1.4</version>

2. 检查项目类型是否为标准 Maven 项目

在 IDEA 创建项目时，应确保选中了“Maven”作为项目类型，并勾选“Create from archetype”。

3. 手动补全目录结构并配置 pom.xml

若项目已创建但缺少目录结构，可手动创建以下目录：

src/
├── main/
│   ├── java/
│   └── resources/
└── test/
    ├── java/
    └── resources/

4. 配置 pom.xml 文件

确保 pom.xml 中包含标准的目录配置：

<build>
    <sourceDirectory>src/main/java</sourceDirectory>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
        </resource>
    </resources>
    <testSourceDirectory>src/test/java</testSourceDirectory>
    <testResources>
        <testResource>
            <directory>src/test/resources</directory>
        </testResource>
    </testResources>
</build>

四、流程图：Maven 项目创建与结构生成流程

graph TD A[开始创建 Maven 项目] --> B{是否选择 Create from archetype?} B -- 否 --> C[手动配置目录结构] B -- 是 --> D[选择 archetype] D --> E{是否选择正确模板?} E -- 否 --> F[结构缺失或错误] E -- 是 --> G[生成标准目录结构] C --> H[配置 pom.xml 文件]