Qt pro 多项目、子目录、多层级配置（超级详细 + 实战模板）
目录
Qt pro 多项目、子目录、多层级配置（超级详细 + 实战模板）
一、核心概念：什么是多项目子目录（subdirs）？
典型项目结构（最标准）
核心规则
二、最外层总 pro（关键！）
三、子项目 pro 写法
1. 库项目 CoreLib.pro
2. 主程序 App.pro
四、多层级嵌套（子目录里还有子目录）
第二层 Libraries.pro
总 Project.pro
五、最常用高级配置
1. 统一输出目录（所有 exe、dll 放一起）
2. 子项目共享配置
3. 指定只编译某些模块
六、总结（面试 + 实战必背）
1. 多项目核心
2. 优点
3. 一句话面试答案
手把手教你：Qt Creator 中配置多项目子目录（subdirs）
一、最终要做成的项目结构（先看结果）
二、第 1 步：创建「总工程」（最关键）
三、第 2 步：往总工程里添加「子项目」
四、第 3 步：Qt Creator 会自动帮你配置好！
五、第 4 步：配置「依赖关系」（必须做）
六、第 5 步：让主程序 App 能使用库
七、第 6 步：统一输出目录（所有 exe、dll 放一起）
八、最终效果（Qt Creator 里长这样）
九、超级重点总结（Qt Creator 多项目口诀）
Qt pro 多项目、子目录、多层级配置（超级详细 + 实战模板）
这是Qt 大型项目必备技能，也是面试高频题，我给你讲最清晰、最标准、可直接落地的多层级 pro 配置方案。
一、核心概念：什么是多项目子目录（subdirs）？
一个大项目分成多个小项目，每个小项目有自己的.pro，最外层用一个总 pro管理它们。
典型项目结构（最标准）
plaintext
MyBigProject/ # 总工程 ├── MyBigProject.pro # 总配置（TEMPLATE = subdirs） ├── App/ # 主程序（exe） │ ├── App.pro │ └── main.cpp ├── CoreLib/ # 核心库（dll/lib） │ ├── CoreLib.pro │ └── xxx.cpp └── UiTools/ # 工具库 ├── UiTools.pro └── xxx.cpp核心规则
- 总 pro：
TEMPLATE = subdirs - 子 pro：
app或lib - 总 pro 用SUBDIRS管理子项目
- 可配置编译顺序、依赖关系
二、最外层总 pro（关键！）
MyBigProject.pro
qmake
TEMPLATE = subdirs # 必须是 subdirs # 子项目目录 SUBDIRS += \ CoreLib \ UiTools \ App # 编译顺序 + 依赖（非常重要） App.depends = CoreLib UiTools UiTools.depends = CoreLibSUBDIRS：列出所有子项目文件夹名xxx.depends：谁依赖谁，控制编译顺序例子：App必须等CoreLib和UiTools先编译完
三、子项目 pro 写法
1. 库项目 CoreLib.pro
qmake
QT += core gui TEMPLATE = lib # 库 TARGET = CoreLib DESTDIR = $$PWD/../bin # 输出到统一目录 SOURCES += xxx.cpp HEADERS += xxx.h2. 主程序 App.pro
qmake
QT += core gui widgets TEMPLATE = app # 可执行程序 TARGET = App DESTDIR = $$PWD/../bin # 引用库 INCLUDEPATH += $$PWD/../CoreLib LIBS += -L$$PWD/../bin -lCoreLib SOURCES += main.cpp四、多层级嵌套（子目录里还有子目录）
支持无限层级，例如：
plaintext
Project/ ├── Project.pro ├── App/ ├── Libraries/ │ ├── Libraries.pro │ ├── Network/ │ └── Database/ └── Tools/第二层 Libraries.pro
qmake
TEMPLATE = subdirs SUBDIRS += Network Database总 Project.pro
qmake
TEMPLATE = subdirs SUBDIRS += Libraries App Tools五、最常用高级配置
1. 统一输出目录（所有 exe、dll 放一起）
qmake
# 在 总 pro 里配置 CONFIG(debug, debug|release) { DESTDIR = $$PWD/bin/debug } else { DESTDIR = $$PWD/bin/release }2. 子项目共享配置
创建一个common.pri文件，所有子 pro 引用：
qmake
include($$PWD/common.pri)3. 指定只编译某些模块
qmake
SUBDIRS += App CoreLib CONFIG += ordered # 按顺序编译六、总结（面试 + 实战必背）
1. 多项目核心
- 总工程：
TEMPLATE = subdirs - 子工程：
app/lib - 用SUBDIRS管理子项目
- 用xxx.depends管理依赖顺序
2. 优点
- 代码解耦
- 模块化
- 大型项目必备
- 方便团队开发
3. 一句话面试答案
Qt 多项目使用 subdirs 模板，总 pro 管理子 pro，可配置编译顺序与依赖，实现模块化分层架构。
手把手教你：Qt Creator 中配置多项目子目录（subdirs）
我用最傻瓜、一步步、可直接照做的方式教你，5 分钟搞定多层级多 pro 工程！
一、最终要做成的项目结构（先看结果）
plaintext
MyProject/ 👈 总工程 ├── MyProject.pro 👈 总 pro（subdirs） ├── App/ 👈 主程序（exe） │ └── App.pro ├── CoreLib/ 👈 核心库（dll） │ └── CoreLib.pro └── Utils/ 👈 工具库（dll） └── Utils.pro二、第 1 步：创建「总工程」（最关键）
打开 Qt Creator → 新建项目
- 选择Other Project→Subdirs Project
- 项目名：
MyProject - 完成创建
✅自动生成的 MyProject.pro 内容：
qmake
TEMPLATE = subdirs SUBDIRS += \ # 这里以后会自动/手动加入子项目三、第 2 步：往总工程里添加「子项目」
右键点击总工程 → 新子项目
可以添加两种：
- App → 生成 exe
- Library → 生成 dll/lib
依次添加：
App（Application）CoreLib（Library）Utils（Library）
四、第 3 步：Qt Creator 会自动帮你配置好！
添加完后，你会发现：
✅MyProject.pro 自动变成：
qmake
TEMPLATE = subdirs SUBDIRS += \ App \ CoreLib \ UtilsQt Creator 全部自动配置，不用你手写路径！
五、第 4 步：配置「依赖关系」（必须做）
比如：
- App 依赖 CoreLib 和 Utils
- Utils 依赖 CoreLib
打开MyProject.pro，在最后加：
qmake
# 编译顺序：先编译被依赖的，再编译依赖的 App.depends = CoreLib Utils Utils.depends = CoreLib✅ 这样 Qt Creator 就会按正确顺序编译！
六、第 5 步：让主程序 App 能使用库
打开App.pro，添加库的路径：
qmake
# 头文件路径 INCLUDEPATH += $$PWD/../CoreLib \ $$PWD/../Utils # 链接库 LIBS += -L$$PWD/../bin -lCoreLib -lUtils七、第 6 步：统一输出目录（所有 exe、dll 放一起）
在MyProject.pro里加：
qmake
# 所有子项目的输出目录都统一到 bin CONFIG(debug, debug|release) { DESTDIR = $$PWD/bin/debug } else { DESTDIR = $$PWD/bin/release }所有子项目会自动继承这个路径，不用每个都配！
八、最终效果（Qt Creator 里长这样）
plaintext
MyProject ├─ App ├─ CoreLib └─ Utils- 点运行→ 自动编译所有子项目
- 点清理→ 全部清理
- 调试、运行、跳转定义全部正常
九、超级重点总结（Qt Creator 多项目口诀）
- 总工程 = Subdirs Project
- 子项目 = 右键添加新子项目
- 编译顺序 = .depends
- 路径统一 = 总 pro 里写 DESTDIR
- Qt Creator 自动管理，不用手写复杂路径
具体案例可看下篇文章