IntelliJ IDEA Module Dependencies 依賴管理：跨 Module 引用的核心規則與避坑指南

Module 依賴的核心假設

在 IntelliJ IDEA 中，若 Module A 依賴 Module B，IDE 會遵循以下默認規則：

• 源碼依賴源碼：Module A 的主源碼依賴 Module B 的主源碼，不依賴 Module B 的測試源碼
• 測試依賴全部：Module A 的測試源碼依賴 Module B 的主源碼和測試源碼

這種設計符合「生產代碼不應依賴測試代碼」的工程原則。

Library 打包進 Artifact 的條件

若需將某 Library 打包進 Artifact（如 WAR/JAR），該 Library 的層級必須為 Project Level 或更高（即 Global Level、Module Level 不夠）。

Exclude 標記的真實行為

將 Library 中的類、文件夾或歸檔內文件標記為 Exclude 後：

• ✅ IDE 代碼提示、導入優化、索引構建會忽略這些內容 → IDE 更流暢
• ❌ 編譯、運行、打包時這些內容仍然生效，不會被真正排除

官方說明：「這樣做的目的是為了讓 IDE 更加流暢」。若需真正排除，請調整構建腳本或依賴範圍。

最佳實踐建議

1. 依賴方向單一化：避免循環依賴，使用 Analyze → Cycle Dependencies 檢測
2. 依賴範圍精確化：compile、test、provided、runtime 嚴格區分
3. 共用代碼抽離：公共工具類、常量、介面抽為獨立 Module（Common/Api），供多方依賴
4. 定期清理：移除未使用的依賴，Maven → Reload Project 或 Gradle Sync 同步

常見問題排查

掌握 IDEA Module 依賴機制，能讓多模組專案結構清晰、構建穩定、開發體驗流暢。