1. 問題背景

在Qt項目開發中，當一個工程包含多個子項目（如庫、插件、測試模塊）時，如何正確管理它們的構建順序和依賴關系？

如：
在開發一個包含核心庫（core）、GUI模塊（gui）、插件（plugins）和測試（tests）的Qt項目時，我們發現：
? 如果plugins在core完成構建前啟動編譯，會導致鏈接失敗
? 當tests同時依賴core和plugins時，手動管理順序極易出錯

# 典型構建錯誤示例
ld: cannot find -lcore  # 核心庫尚未編譯完成

---

2. 為什么需要管理子項目依賴？

在復雜 Qt 項目中，模塊通常存在依賴關系，例如：
? 插件（plugins） 依賴 核心庫（core）
? 測試（tests） 依賴 主程序（app）和庫（lib）

如果構建順序錯誤，可能導致：
? 鏈接失敗（未找到依賴庫）
? 運行時錯誤（插件未正確初始化）
? 維護困難（新增模塊時需手動調整順序）

因此，Qt提供了兩種方式管理依賴，但它們的適用場景不同。
常見的兩種方式：

1. depends 顯式聲明依賴
2. CONFIG += ordered 順序構建

但，哪種方式更符合現代 Qt 開發的最佳實踐？

---

3. depends：顯式依賴聲明（官方推薦）

3.1 基本語法

TEMPLATE = subdirs
SUBDIRS = core gui plugins tests# 顯式聲明依賴
gui.depends = core           # gui 依賴 core
plugins.depends = core gui   # plugins 依賴 core 和 gui
tests.depends = core         # tests 僅依賴 core

3.2 優勢

1. 精準控制依賴
   ? 明確指定誰依賴誰，避免隱式順序問題。
   ? 支持 非線性依賴（如多個插件依賴同一個庫）。

2. 可維護性高
   ? 新增模塊時，只需添加 depends，無需調整 SUBDIRS 順序。
   ? 適合大型項目，模塊化清晰。

3. 官方明確推薦

   “For complex dependencies between subprojects, use the depends variable instead of CONFIG += ordered.”
   —— Qt 6 官方文檔

3.3 適用場景

? 模塊化項目（庫 + 插件 + 測試）。
? 存在交叉依賴（如多個子項目依賴同一個核心模塊）。

---

4. CONFIG += ordered：順序構建（舊式方案）

4.1 基本語法

TEMPLATE = subdirs
CONFIG += ordered
SUBDIRS = core gui plugins tests  # 嚴格按順序構建：core → gui → plugins → tests

當新增database模塊需要插入到core和gui之間時：

1. 必須手動調整SUBDIRS順序
2. 可能破壞既有依賴關系
3. 需要全面回歸測試

4.2 存在問題

1. 過于死板
   ? 必須確保 SUBDIRS 順序完全匹配依賴關系，否則構建失敗。
   ? 新增模塊時需手動調整順序，容易出錯。

2. 無法表達復雜依賴
   ? 如果 tests 依賴 core，但 plugins 也依賴 core，ordered 無法直接表達。

4.3 殘留用途

? 極簡單的線性依賴項目（如 A → B → C）。
? 歷史遺留代碼維護。

---

5. 對比分析

特性	depends	CONFIG += ordered
依賴表達方式	顯式聲明（A.depends = B）	隱式順序（SUBDIRS 列表順序）
適用項目規模	中大型項目	極簡單項目
維護成本	低（新增模塊只需加依賴）	高（需調整順序）
官方推薦度	? 推薦	?? 不推薦

---

6. 示例

6.1 現代 Qt 項目推薦寫法

TEMPLATE = subdirs
SUBDIRS = core utils gui plugins tests #(與順序無關)# 顯式聲明依賴
utils.depends = core          # utils 依賴 core
gui.depends = core utils      # gui 依賴 core 和 utils
plugins.depends = gui         # plugins 依賴 gui
tests.depends = core utils    # tests 依賴 core 和 utils

6.2 遺棄用法

TEMPLATE = subdirs
CONFIG += ordered
SUBDIRS = core utils gui plugins tests  # 依賴關系隱含在順序中，難以維護

---

7. 結論

1. 優先使用 depends
   ? 它是 Qt 官方推薦的方案，適合絕大多數項目。
   ? 提供更好的可讀性、可維護性和靈活性。

2. 避免 CONFIG += ordered
   ? 僅用于舊代碼兼容或極其簡單的線性構建。

3. 保持依賴聲明清晰
   ? 使用注釋分組依賴，例如：

   # Core dependencies
   gui.depends = core
   plugins.depends = core gui
   

提示：在Qt Creator中，右鍵點擊項目 → "Run qmake"可以實時驗證依賴關系是否正確解析。