Spring Boot目录变文件夹？3步解决！

在 Spring Boot 项目中，当你在 src/main/java 下看到目录结构而不是包结构时，这通常是 IDE（如 IntelliJ IDEA）的显示问题或项目配置问题。以下是原因和解决方案：

问题原因

1. IDE 未正确识别 Java 源代码根目录

   • src/main/java 没有被标记为 Sources Root（源代码根目录）
   • 导致 IDE 将其视为普通文件夹而非 Java 包结构

2. 包名不符合 Java 规范

   • Java 包名要求全小写字母（如 com.example）
   • 如果目录名包含大写字母或非法字符（如 SpringbootMybatisDay10A），IDE 可能不会识别为包

3. 项目构建工具配置问题

   • Maven/Gradle 配置错误，未正确指定源代码路径

解决方案

方法 1：在 IDE 中标记源代码根目录（推荐）

以 IntelliJ IDEA 为例：

1. 右键点击 src/main/java 目录
2. 选择 Mark Directory as → Sources Root

   Project
   └── src
       └── main
           ├── java       [Mark as Sources Root]  ✅
           └── resources
   

3. 刷新项目：IDE 会自动将目录转换为包结构

方法 2：修正包名（全小写）

1. 将包名改为全小写（Java 规范要求）：

   - com.shmily.springbootmybatisday10.mapper.SpringbootMybatisDay10A
   + com.shmily.springbootmybatisday10.mapper.springbootmybatisday10a
   

2. 在 IDE 中重命名目录：
   • 右键目录 → Refactor → Rename
   • 使用全小写格式（如 springbootmybatisday10a）

方法 3：检查 Maven 配置

确保 pom.xml 正确指定了源代码目录：

<build>
    <sourceDirectory>src/main/java</sourceDirectory>
</build>

方法 4：重建项目结构

如果以上无效，手动创建包：

1. 在 src/main/java 下右键 → New → Package
2. 按层级输入包名（用 . 分隔）：

   com.shmily.springbootmybatisday10.mapper
   

3. IDE 会自动生成嵌套的包结构：

   src/main/java
   └── com
       └── shmily
           └── springbootmybatisday10
               └── mapper  [Package图标]
   

预期效果 vs 错误效果

预防措施

1. 创建项目时使用正确命名：
   • 在 Spring Initializr 中，使用全小写的 Group 和 Artifact：

     Group: com.shmily
     Artifact: springbootmybatisday10
     

2. 避免手动创建目录：
   • 始终通过 IDE 的 New → Package 创建包
3. 检查项目配置：
   • 确保 src/main/java 是 Sources Root
   • 确保 src/test/java 是 Test Sources Root

💡 在 IntelliJ IDEA 中，黄色图标表示 Java 包，蓝色图标表示普通目录。通过正确标记 Sources Root，你的目录结构会自动转换为包结构。