快捷導(dǎo)航

SpringBoot目錄變文件夾的原因和解決方案

更新時(shí)間：2025年07月16日 09:02:57 作者：六七_(dá)Shmily

在 Spring Boot 項(xiàng)目中,當(dāng)你在 src/main/java 下看到目錄結(jié)構(gòu)而不是包結(jié)構(gòu)時(shí),這通常是 IDE（如 IntelliJ IDEA）的顯示問題或項(xiàng)目配置問題,以下是原因和解決方案,需要的朋友可以參考下

問題原因

IDE 未正確識(shí)別 Java 源代碼根目錄

src/main/java 沒有被標(biāo)記為 Sources Root（源代碼根目錄）
導(dǎo)致 IDE 將其視為普通文件夾而非 Java 包結(jié)構(gòu)

包名不符合 Java 規(guī)范

Java 包名要求全小寫字母（如 com.example）
如果目錄名包含大寫字母或非法字符（如 SpringbootMybatisDay10A），IDE 可能不會(huì)識(shí)別為包

項(xiàng)目構(gòu)建工具配置問題

Maven/Gradle 配置錯(cuò)誤，未正確指定源代碼路徑

解決方案

方法 1：在 IDE 中標(biāo)記源代碼根目錄（推薦）

以 IntelliJ IDEA 為例：

右鍵點(diǎn)擊 src/main/java 目錄
選擇 Mark Directory as → Sources Root

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

刷新項(xiàng)目：IDE 會(huì)自動(dòng)將目錄轉(zhuǎn)換為包結(jié)構(gòu)

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

將包名改為全小寫（Java 規(guī)范要求）：

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

在 IDE 中重命名目錄：
- 右鍵目錄 → Refactor → Rename
- 使用全小寫格式（如 springbootmybatisday10a）

方法 3：檢查 Maven 配置

確保 pom.xml 正確指定了源代碼目錄：

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

方法 4：重建項(xiàng)目結(jié)構(gòu)

如果以上無效，手動(dòng)創(chuàng)建包：

在 src/main/java 下右鍵 → New → Package
按層級(jí)輸入包名（用 . 分隔）：

com.shmily.springbootmybatisday10.mapper

IDE 會(huì)自動(dòng)生成嵌套的包結(jié)構(gòu)：

src/main/java
└── com
    └── shmily
        └── springbootmybatisday10
            └── mapper  [Package圖標(biāo)]

預(yù)期效果 vs 錯(cuò)誤效果

正確狀態(tài)（包）	錯(cuò)誤狀態(tài)（目錄）
顯示為黃色圓點(diǎn)圖標(biāo)	顯示為普通文件夾圖標(biāo)
可創(chuàng)建 Java 類文件	無法直接創(chuàng)建 Java 類
包名用 . 分隔層級(jí)	目錄名顯示完整路徑

預(yù)防措施

創(chuàng)建項(xiàng)目時(shí)使用正確命名：

在 Spring Initializr 中，使用全小寫的 Group 和 Artifact：

Group: com.shmily
Artifact: springbootmybatisday10

避免手動(dòng)創(chuàng)建目錄：
- 始終通過 IDE 的 New → Package 創(chuàng)建包
檢查項(xiàng)目配置：
- 確保 src/main/java 是 Sources Root
- 確保 src/test/java 是 Test Sources Root