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即可图形化完成
补充必要配置文件和顶层结构
目录建好后，别忘了在项目根目录添加这些关键文件：
立即学习“Java免费学习笔记（深入）”；
- 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才顺。不复杂但容易忽略细节。
