Java项目目录结构怎么建？初始化步骤全解析

Java项目标准目录结构遵循Maven/Gradle约定，核心是src/main/java、src/main/resources、src/test/java、src/test/resources四大目录，配合pom.xml等配置文件实现可靠构建与协作。

Java项目的标准目录结构不是随意组织的，而是遵循Maven或Gradle等构建工具约定的规范，这样能让编译、测试、打包和协作更可靠。核心是区分源码、资源、测试代码和构建产物，避免手动配置出错。

明确主模块的四大基础目录

一个典型的Java项目（以Maven为例）根目录下应包含以下四个关键子目录：

• src/main/java：存放所有生产环境的Java源代码，包路径从这里开始映射（如com.example.app对应src/main/java/com/example/app）
• src/main/resources：放配置文件（application.properties、logback.xml）、静态资源、SQL脚本等非Java但运行时需要的文件
• src/test/java：存放JUnit或TestNG测试类，包结构与main/java一致，便于对应验证
• src/test/resources：专供测试使用的配置或模拟数据（如test-application.yml），不会打入最终jar

初始化命令行快速建好骨架

不用手动一层层创建文件夹。推荐用Maven Archetype一键生成：

• 运行：mvn archetype:generate -DgroupId=com.example -DartifactId=myapp -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
• 执行后自动生成标准目录+示例HelloWorld类+pom.xml
• 若用IDEA，新建项目选“Maven”，勾选“Create from archetype”，选maven-archetype-quickstart即可图形化完成

补充必要配置文件和顶层结构

目录建好后，别忘了在项目根目录添加这些关键文件：

• pom.xml（Maven）或build.gradle（Gradle）：定义依赖、插件、构建行为
• .gitignore：排除target/、out/、*.iml、.idea/等生成物，避免提交垃圾文件
• README.md：简要说明项目用途、如何编译运行（如mvn clean compile、mvn test）

常见误区提醒

新手容易踩的坑：

• 把配置文件直接扔在src/main/java里——会导致编译失败或运行时报FileNotFoundException
• 测试类放在src/main/test这种自定义路径——构建工具找不到，测试不会执行
• 多个module没分清层级，把子模块的src直接放在父项目根下——应使用parent/pom.xml + parent/module-a/src结构

基本上就这些。目录结构定好了，后续加依赖、写单元测试、集成CI才顺。不复杂但容易忽略细节。