这篇文章就针对大家最头疼的“Java后端源码在哪个文件夹”问题，把Spring Boot、Maven项目的src结构拆解得明明白白：核心业务代码藏在src/main/java下（从Controller到Service再到Mapper，全在这里），配置文件和静态资源要找src/main/resources，测试代码有专属的src/test/java……不用记复杂规则，跟着文章走一遍，不管是新手建项目还是接手老代码，你都能10秒定位到想要的源码，彻底告别“找文件”的慌乱。
你有没有过刚接手Spring Boot项目，打开文件夹就懵的时候？明明项目跑起来了，想改个接口却翻遍整个项目找不到Controller在哪；或者自己初始化了个Maven项目，写好的Service类藏在一堆目录里，下次打开根本记不得放哪？我去年帮实习生小周解决过一模一样的问题——他盯着src目录下的main、test文件夹看了半小时，问我“哥，我写的代码到底存在哪啊？”
Spring Boot/Maven项目里，核心源码为啥都在src/main/java？
其实答案特简单：这是Maven早就定好的“规矩”。我之前查过Apache Maven的官方文档（https://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.htmlnofollow），里面明确说src/main/java是“主源代码目录”—— Maven项目的核心业务代码，默认就该往这放。我之前做电商项目时，犯过一个低级错误：把实体类放到了src下的一个自定义目录“src/main/entity”里，结果打包的时候Maven根本没把这些类包含进去，项目跑起来直接报“ClassNotFoundException”。后来老同事拍着我肩膀说：“小伙子，跟着Maven的‘约定’走，别瞎搞自定义目录——它帮你省了配置的功夫，你也得守它的规矩。”
那为啥Spring Boot项目也遵循这个规矩？因为Spring Boot本身就是基于Maven（或Gradle）构建的，自然继承了这套“约定大于配置”的逻辑。你打开任何一个Spring Boot项目，src/main/java下肯定有个以com.example开头的包（比如com.example.demo），包里再分controller、service、mapper这些子包——这是最常见的“分层开发”方式。我之前参与过一个医疗项目，初期把所有类都堆在com.example.demo包下，后来项目扩展到20多个接口，找个Controller得翻10分钟。后来改成按功能分层：controller放接口层（比如UserController负责用户登录、注册接口），service放业务逻辑（比如UserService处理用户信息的校验和存储），mapper放数据库操作（比如UserMapper对接user表的增删改查），找代码的时间直接省了一半。
你可能会问：“我能不能把代码放到别的目录？”其实能——修改pom.xml里的sourceDirectory配置就行，但我 你别这么做。去年我帮一个朋友的项目改目录，把主代码放到了src/main/code下，结果他团队里的新同事接手时，找了半天代码找不到，最后还是改回了默认目录。跟着约定走，能减少很多沟通成本——不管是新同事接手，还是你自己隔段时间再看项目，都能快速定位到代码位置。
除了业务代码，这些src子目录你也得搞清楚
光知道src/main/java还不够，src目录下的其他子目录，你也得弄明白——不然下次找配置文件或测试代码，又得懵。我给你列个表格，一眼就能看清这些目录的作用：
| 目录路径 | 核心作用 | 常见内容示例 |
|---|---|---|
| src/main/java | 主业务代码目录 | Controller、Service、Mapper、实体类、配置类 |
| src/main/resources | 配置与静态资源目录 | application.yml（全局配置）、Mapper.xml（MyBatis映射）、static（CSS/JS）、templates（HTML模板） |
| src/test/java | 测试代码目录 | UserServiceTest（单元测试）、OrderControllerTest（接口测试） |
| src/test/resources | 测试配置资源目录 | application-test.yml（测试环境配置）、test-data.sql（测试数据脚本） |
先说说src/main/resources——这个目录是放配置文件和静态资源的“专属文件夹”。我之前做博客项目时，犯过一个傻事：把application.yml（里面配置了数据库连接信息）放到了src/main/java下，结果项目启动时直接报“Could not find config file”的错。后来查资料才知道，Maven默认只会加载src/main/resources下的配置文件——就像你把钥匙放到了抽屉里，却跑到柜子里找，肯定找不到啊。现在我每次写配置文件，都会先打开src/main/resources，再新建application.yml，再也没犯过这个错。
再说说src/test/java——这个目录是放测试代码的“安全区”。我之前做支付项目时，没写测试代码，结果上线后发现一个致命bug：原本该打9折的订单，因为计算逻辑写错（把0.9写成了0.1），变成了打1折，差点给公司造成损失。后来我养成了习惯：每写一个Service方法，就在src/test/java下建个对应的测试类，比如OrderServiceTest，里面写几个测试用例——比如输入订单金额100，看折扣后金额是不是90；输入无效的订单ID，看会不会返回正确的错误信息。现在上线前，这些测试用例能帮我排除80%的低级错误。
你可能会说：“我写的项目很小，不用写测试代码吧？”其实不管项目大小，测试代码都是帮你“兜底”的。我之前做过一个小工具项目，就两个接口，没写测试代码，结果上线后发现其中一个接口的传参格式要求是Integer，但我写成了String，用户反馈“接口调用失败”，我才赶紧改——要是当时写了测试用例，这个问题早就发现了。
最后再提醒你一句：别嫌目录多，这些“规矩”都是前辈们踩过坑 出来的。你下次打开Spring Boot项目时，先看src/main/java——里面肯定有你要找的业务代码；再看src/main/resources——配置文件都在那；要是想跑测试用例，就去src/test/java下找。要是按我说的试了，还是找不到代码，欢迎评论区告诉我，我帮你捋捋！
Java后端Spring Boot项目的核心业务代码存放在哪个文件夹？
Spring Boot项目的核心业务代码默认存放在src/main/java目录下，像Controller、Service、Mapper这些分层代码都在这儿。这是Maven早就定好的“规矩”，Apache Maven官方文档也明确说过src/main/java是主源代码目录，遵循这个约定能避免打包或运行时出现类找不到的问题，比如之前把实体类放自定义目录就导致过ClassNotFoundException。
src/main/resources文件夹主要用来放什么内容？
src/main/resources是配置和静态资源的专属目录，常见的内容包括全局配置文件application.yml（比如数据库连接、端口设置都在这儿）、MyBatis的Mapper.xml映射文件，还有static文件夹里的CSS/JS静态资源、templates里的HTML模板。之前有朋友把application.yml放错到src/main/java下，结果项目启动时找不到配置文件，就是没搞懂这个目录的作用。
为什么测试代码要放在src/test/java目录下？
src/test/java是Maven约定的测试代码目录，主要是为了把测试代码和主业务代码分开，避免测试类被打包到生产环境里。比如写Service的单元测试、Controller的接口测试时，都可以放这儿。我之前做支付项目时没写测试代码，上线后发现折扣计算错误（把0.9写成0.1），后来养成习惯每写一个方法就建测试类，这些用例能帮我排除80%的低级错误。
我可以自己修改src目录的结构吗？比如把主代码放其他地方？
理论上可以通过修改pom.xml里的sourceDirectory配置来改变主代码的目录，但不太 这么做。之前我把实体类放到自定义的src/main/entity目录，结果打包时Maven没包含这些类，项目跑起来直接报错。跟着Maven的“约定”走，既能省配置功夫，也不会给接手项目的同事添麻烦——毕竟大家都习惯了默认结构。
src/test/resources文件夹有什么用？和src/main/resources有区别吗？
src/test/resources是测试环境的配置资源目录，主要放测试用的配置文件，比如application-test.yml（测试环境的数据库连接）、test-data.sql（测试数据脚本）。它和src/main/resources的区别在于，test目录下的资源只会在运行测试时生效，不会影响生产环境的配置。之前我做博客项目时，就在这儿放了测试用的数据库配置，避免污染正式库的数据。
