Qt Creator怎么管理多个项目?

陌萱大大_2964

陌萱大大_2964

2026-08-10

415人浏览

原创

单个 Qt Creator 实例可同时管理多个项目,关键在于正确配置 SUBDIRS 容器项目(TEMPLATE = subdirs)、子项目构建顺序(SUBDIRS 列表顺序)与依赖(.depends)、Kit(Qt 版本+编译器+调试器三件套匹配)、运行设置(禁用“Stop running application”)及跨项目路径(INCLUDEPATH、LIBS 使用 $$PWD 和 $$OUT_PWD)。

qt creator怎么管理多个项目?

单个 Qt Creator 实例就能同时管理多个项目,不需要装多个 IDE 或反复切换窗口——关键不是“能不能”,而是 SUBDIRS 项目结构和 Kit 配置是否对路。

用 SUBDIRS 创建统一容器项目

这不是“打开多个项目”的临时方案,而是把多个子项目纳入一个逻辑单元的正式做法。主项目必须是 TEMPLATE = subdirs,否则 Qt Creator 不会识别其下的子项目为构建单元。

  • SUBDIRS 列表顺序默认就是构建顺序,比如 SUBDIRS += libcore appmain tests 表示先编译 libcore,再编译 appmain,最后跑测试
  • 想强制依赖(比如确保 appmain 总在 libcore 之后链接),得加 appmain.depends = libcore 到主 .pro 文件里,光靠顺序不够可靠
  • 每个子项目必须有独立的 .pro 文件,且 TEMPLATE 要明确:是 app、lib 还是 subdirs,混用会导致 qmake 解析失败

Kit 配置决定多版本共存上限

Qt Creator 能否同时支持 Qt5.14.2 和 Qt6.5,不取决于你装了多少个 Qt,而取决于 Kit 是否完整注册了对应版本 + 编译器 + 调试器三件套。

  • 进 Tools → Options → Kits,检查每个 Kit 的 Qt version 是否指向正确的 qmake 路径(例如 Qt5.14.2/5.14.2/mingw81_64/bin/qmake.exe)
  • 同一编译器(如 MinGW 11.2)不能被两个不同 Qt 版本的 Kit 共享——Qt6 要求 C++17,Qt5.14 默认只认 C++11,Kit 会静默禁用不匹配的组合
  • 如果某个子项目用了 Qt6 的新 API(比如 QRegularExpression 的某些重载),但 Kit 绑的是 Qt5 的 qmake,构建时不会报错,但运行时可能崩溃或行为异常

运行多个可执行子项目要关掉“单实例限制”

默认情况下,Qt Creator 只允许一个可执行项目处于“运行中”状态,其余会被自动终止——这不是 bug,是防止调试冲突的设计,但开发联调时很碍事。

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载
  • 进 Tools → Options → Build & Run → General,把 Run configuration 下的 Run in terminal 旁的 Stop running application before starting another 勾去掉
  • 更彻底的解法:在 Projects → Build & Run → Run Settings 中,为每个 app 子项目单独设置 Run configuration,并启用 Run in terminal,这样它们会各自开终端窗口,互不干扰
  • 注意:QProcess 启动另一个子项目的可执行文件时,路径必须写绝对路径或相对于构建目录的路径,不能依赖 $$OUT_PWD —— 因为 $$OUT_PWD 在不同子项目里指向不同目录

子项目间头文件和库链接容易漏掉这两步

即使 SUBDIRS 结构正确,子项目之间调用仍常因路径和链接配置缺失而报 undefined reference 或 file not found。

  • 头文件包含:在调用方 .pro 里加 INCLUDEPATH += $$PWD/../libcore(注意是 $$PWD,不是 $$OUT_PWD),否则 moc 无法解析 #include "libcore.h"
  • 链接库:若 libcore 输出的是动态库,调用方需写 LIBS += -L$$OUT_PWD/../libcore -llibcore;若是静态库,还得加 CONFIG += staticlib 到 libcore.pro,否则生成的是 .dll/.so,不是 .a/.lib
  • Qt6 的模块依赖更严格:Qt5 里 QT += widgets 可以隐式带入 core 和 gui,Qt6 必须显式写全 QT += core gui widgets,否则 QWidget 直接编译不过

真正麻烦的从来不是怎么建结构,而是每个子项目的 .pro 文件里那几行路径和依赖配置——差一个 / 或漏一个 $$,就卡住一上午。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
C++ Qt图形开发
C++ Qt图形开发

本专题专注于 C++ Qt框架在图形界面开发中的应用,系统讲解窗口设计、信号与槽机制、界面布局、事件处理、数据库连接与跨平台打包等核心技能,通过多个桌面应用项目实战,帮助学员快速掌握 Qt 框架并独立完成跨平台GUI软件的开发。

2025.08.15

5422

7

C++桌面程序开发
C++桌面程序开发

本专题聚焦 C++ 在桌面端图形界面应用开发中的实战应用,系统讲解 Qt 框架的信号与槽机制、界面布局管理、事件响应、数据交互、样式美化与多窗口应用设计等核心知识。通过实战案例(如记事本应用、数据管理工具、系统监控面板),帮助学习者掌握 从UI设计到完整桌面软件开发的C++工程化能力。

2025.10.23

1454

13

C++ 图形界面开发基础(Qt方向)
C++ 图形界面开发基础(Qt方向)

本专题系统讲解 使用 C++ 与 Qt 进行图形界面(GUI)开发的核心技能,内容涵盖 Qt 项目结构、窗口组件、信号与槽机制、事件处理、布局管理、资源管理,以及跨平台编译与打包流程。通过多个小型桌面应用实战案例,帮助学习者掌握从界面设计到功能实现的完整 GUI 开发能力。

2025.12.05

1441

15

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

2026.10.28

60

16

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

2026.10.28

20

15

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

2026.10.28

40

10

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

2026.10.22

140

11

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

2026.10.22

80

10

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

2026.10.22

80

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Qt入门课堂 - Qt Quick Controls
Qt入门课堂 - Qt Quick Controls

共0课时 | 0人学习

Qt Creator 调试文档
Qt Creator 调试文档

共0课时 | 0人学习

Qt Creator 项目创建文档
Qt Creator 项目创建文档

共0课时 | 0人学习