《Qt从零入门系列（三）：Qt Creator详解——从项目创建到开发界面熟悉》

上一篇文章中，我们初步认识了Qt这个跨平台C++开发框架，从它的发展历史、核心特点，到实际应用场景，建立了对Qt整体生态的基本认知。不过，了解Qt是什么只是第一步。真正开始Qt 开时，我们首先要面对的问题就是：

如何搭建开发环境？如何创建一个Qt项目？Qt程序到底是在哪里编写、构建和运行的？

这时候，Qt Creator就成为了开发者与Qt世界之间最重要的桥梁。

Qt Creator是Qt官方提供的集成开发环境（IDE），它不仅负责代码编写，还集成了项目管理、界面设计、编译构建、程序调试等完整开发流程。对于初学者来说，Qt Creator看起来可能有些复杂：各种模式、构建套件、项目模板、配置选项让人眼花缭乱。

但实际上，这些功能背后都有明确的设计逻辑。

为什么创建 Qt 项目时需要选择模板？ 为什么需要配置 Qt Kit？ 为什么同一个项目可以选择不同编译环境？ UI 界面又是如何和 C++ 代码关联起来的？

这些问题，正是学习Qt开发必须跨过的第一道门槛。

本文将从Qt Creator的基础使用开始，带你认识开发界面的各个组成部分，并完整走一遍Qt项目的创建流程。从项目模板选择、路径配置、构建系统，到最终运行程序，逐步理解一个Qt工程是如何诞生的。掌握Qt Creator，不只是学会几个按钮怎么点击，更重要的是理解Qt工程背后的组织方式，为后续学习Qt窗口开发、信号与槽机制、UI设计以及大型项目架构打下基础。

目录

1.1 Qt Creator界面概览

​编辑①菜单栏——开发功能的集中入口

②模式选择——切换不同开发场景

③构建套件选择器——管理编译环境

④欢迎模式——项目管理起点

⑤定位器——快速搜索与跳转

⑥输出窗格——查看编译与运行信息

⑦会话记录——管理开发上下文

⑧新建项目入口

⑨打开已有项目入口

二、使用Qt Creator创建第一个Qt项目

2.1 项目创建流程详解

2.1.1 创建新项目

2.1.2 选择项目模板——确定应用类型

2.1.3 设置项目路径——规划工程目录

2.1.4 选择构建系统——CMake与qmake

2.1.5 配置类信息——生成基础代码框架

2.1.6 选择开发语言与翻译文件

2.1.7 配置Qt编译套件（Kit）

2.1.8 选择版本控制系统

2.1.9 项目创建完成后的最终效果

2.2 项目创建最佳实践

2.2.1 规范化创建Qt工程

2.2.2 编译与运行项目

三、深入认识Qt Creator开发界面

3.1 左侧功能栏——项目管理与开发辅助

3.2 代码编辑区——核心编码区域

3.3 UI 设计界面——可视化界面开发

3.4 构建区域——编译、调试与运行管理

3.5 Qt Creator使用技巧与开发建议

1.1 Qt Creator界面概览

从开始菜单或桌面快捷方式启动Qt Creator，映入眼帘的是一个功能分区清晰的集成开发环境。首次启动后的主界面大致如下，这扇门背后，就是你接下来构建所有Qt应用程序的核心工作台。我们先快速扫一遍界面上的几个关键区域，搞清楚每个部分是干什么的，后面写代码时会顺畅很多。

①菜单栏——开发功能的集中入口

菜单栏横跨顶部，一共八个选项，把Qt Creator的核心功能分了门、别了类。刚上手不用逐项死记，扫一遍留个印象，后面用到时知道去哪里找就行。

②模式选择——切换不同开发场景

Qt Creator把整个开发流程拆成了六个工作模式，分别对应不同的任务阶段。根据当前在干什么，一键切到对应模式，工具栏和侧边栏会跟着自动调整，只显示当前需要的面板，保持界面始终干净。

③构建套件选择器——管理编译环境

这个区域紧挨着模式选择栏的下方，把编译、运行、调试相关的几个核心操作浓缩成了四个图标按钮。日常开发里，这几个按钮的点击频率最高。

④欢迎模式——项目管理起点

欢迎模式是你每次启动Qt Creator后看到的第一个界面，也可以随时通过左侧模式选择栏切回来。它像一个中央大厅，把最常用的几个入口集中摆在这里：

• Projects（项目）：新建工程或打开已有项目。刚装好Qt想从零开始写第一个程序，就点这里。

• 示例：Qt官方精心准备的大量范例程序。从简单的窗口到复杂的网络应用，分门别类排好，还支持关键词搜索。不知道某个控件怎么用，最快的方式是来这里搜一个现成的例子跑起来看看。

• 教程：Qt官方提供的视频教学资源，不过是英文的。有一定英文阅读能力的同学可以当作进阶学习材料。

⑤定位器——快速搜索与跳转

定位器是Qt Creator里一块很容易被新手忽略、但一旦用起来就回不去的高效入口。它本质上是一个全能搜索栏，输入关键字，它就能在项目、文件、类、函数、帮助文档甚至文件系统里同时匹配，把结果快速列出来。配合不同的前缀过滤器（比如c搜类、m搜方法、f搜文件），可以进一步缩小范围，精准定位到你要找的那个东西。想打开某个源文件、跳转到某个类的定义、查阅某个函数的帮助，不用一层层展开目录树，直接在定位器里敲几键，回车直达。

⑥输出窗格——查看编译与运行信息

输出窗格是Qt Creator底部的信息中枢，编译报错、程序运行日志、搜索结果全都汇聚在这里。它包含七个选项卡，分别对应七种不同类型的输出信息，用快捷键Alt + 1~7可以在它们之间快速切换。

另外三个选项卡，Debugger Console、概要信息、测试结果，分别对应调试时的GDB命令行交互、项目构建摘要，以及单元测试的通过/失败统计。日常开发里，问题和应用程序输出是最频繁查阅的两个窗口，一个是写代码时的纠错器，一个是跑代码时的监视器，把这两个盯紧，大部分调试任务就有了头绪。

⑦会话记录——管理开发上下文

Qt Creator会自动记住你上一次关闭时正在处理的项目，下次启动时一键恢复，不用手动翻目录去找。同时支持会话的Clone操作，想基于当前工作状态开一个临时分支去验证某个想法，克隆一份会话就行，不会弄乱原来的环境。如果当前没有打开任何工程，这里显示的就是最后一次关闭时的工程会话。

⑧新建项目入口

从这里创建一个全新的Qt项目。初次使用时，Qt Creator会引导你选择项目类型（如Widgets应用、控制台程序、Quick应用等），然后自动生成一套包含基础代码和配置文件的工程模板。不用从空文件夹开始，模板已经把骨架搭好了。

⑨打开已有项目入口

加载本地磁盘上已有的Qt项目或CMake工程。支持.pro、.CMakeLists.txt等常见工程文件格式。从GitHub 上 clone下来的开源Qt项目，用这个入口打开就能直接开始编译运行。

二、使用Qt Creator创建第一个Qt项目

2.1 项目创建流程详解

2.1.1 创建新项目

万事开头难，但在 Qt Creator 里建项目并不难。启动 Qt Creator 后，你有三条路径可以快速抵达“新建项目”的入口，任选一种最顺手的方式即可：

• 菜单栏正路：点击顶部菜单栏 “文件” → “新建文件或项目”，这是最稳妥、最不会迷路的官方路径。
• 键盘党专属：直接按下快捷键Ctrl + N，手指不离键盘，窗口即刻弹出。
• 欢迎界面一键启动：如果还停留在刚打开Qt Creator的欢迎模式，直接点击那个醒目的“New”按钮，效果完全一样。

在欢迎模式下，直接点击醒目的“New”按钮，即可进入新建项目流程，如下图所示。这是最快捷的入口，不用翻菜单，不用记快捷键，鼠标一点直接开始。

2.1.2 选择项目模板——确定应用类型

弹出如下对话框：

新建项目对话框里列出了五类项目模板，分别对应不同的开发起点，按需选择：

对于刚上手Qt的开发者，绝大部分场景选第一个Application就对了。具体选Widgets还是 Quick，取决于你要做传统控件式界面还是现代触摸式界面。

Application 是五类模板中最常用的一个，选中它之后，右侧会列出五个子模板，分别对应不同的应用类型：

• Qt Widgets Application：传统窗体程序，基于C++代码和widget组件搭建界面。这是大多数桌面应用开发的首选，也是我们后续示例的主力模板。
• Qt Console Application：纯控制台程序。由于Qt的核心优势在于图形界面，这个模板极少使用除非你只是想借Qt的跨平台能力跑一些后端逻辑。
• Qt for Python：用Python调用Qt库，在LGPL许可下开发闭源应用。适合习惯Python生态的开发者。
• Qt Quick Application：基于QML的现代UI框架，专门为移动端和嵌入式设备打造流畅的触摸界面。提供了声明式编程模型，集成了动画、粒子效果、交互手势等一整套视觉组件。

选哪个模板，Qt Creator后续生成的初始代码骨架就完全不同。对于初学者，Qt Widgets Application是最稳的起点，它用C++直接操纵控件，概念清晰，跟操作系统底层打交道也更直观。等把这套传统模型吃透之后，再去碰Qt Quick会轻松很多

2.1.3 设置项目路径——规划工程目录

给Qt项目命名及选择保存项目的路径；

2.1.4 选择构建系统——CMake与qmake

选择Qt项目的构建系统，使用默认的“qmake”即可。

Qt Creator中主要提供三种构建工具可选，分别是qmake、CMake和Qbs。它们的共同目标是：把一堆源代码和资源文件，变成最终能跑起来的可执行程序。但各自的实现路径和适用场景差异不小。

• qmake：Qt原生的构建工具，也是目前Qt社区里使用最广泛的选项。它通过解析.pro文件自动生成 Makefile，语法简洁，与Qt的集成最为紧密，跨平台支持成熟。对于大多数Qt项目，尤其是中小型工程，qmake是最直接、最省事的选择。
• CMake：一个独立的第三方构建系统生成器。它本身不直接编译代码，而是根据CMakeLists.txt中描述的项目结构，输出Makefile、Visual Studio工程文件或Ninja脚本等后端构建文件。CMake的优势在于生态庞大、可扩展性强，适合需要集成非Qt库或构建流程高度定制的大型项目。
• Qbs：Qt Build Suite，曾经被寄予厚望的下一代构建工具。它从项目描述中自动推导依赖关系，编译速度比qmake更快，且不与特定Qt版本绑定。但Qt官方已因市场策略原因宣布弃用Qbs，不建议在新项目中继续投入。

对于Qt初学者和大多数常规项目，qmake是最稳妥的起点，文档丰富，社区支持广泛，与Qt Creator的配合最默契。如果项目规模较大，或者需要与大量第三方C/C++库协同工作，可以逐步过渡到CMake。Qbs了解即可，不必深入。

2.1.5 配置类信息——生成基础代码框架

创建图形界面程序之前，还需要选定一个基类。Qt提供了三种最常用的基类，分别对应不同的窗口类型和场景复杂度：

三种基类的选择其实反映了界面的三个层次：QWidget是原子，所有可视元素都是它的子孙；QDialog是专才，在QWidget的基础上封装了对话框特有的行为；QMainWindow是完整框架，为大型桌面应用提供了一整套标准骨架。对于初学者，建议从QWidget入手，先弄清楚控件的父子关系与布局原理；后续编写正式桌面应用时，再切换到QMainWindow，充分利用其菜单、工具栏和状态栏的便利。

上述三个类之间的关系如下图：

2.1.6 选择开发语言与翻译文件

这个页面的标题容易让人产生一瞬间的困惑，但这里选择的“语言”，不是指C++或Python这类编程语言，而是指你的应用程序将来运行时，界面上显示给用户看的文字语言，比如“汉语”、“英语”。

简单说，这一步是在配置你程序的国际化（i18n）支持。如果你希望开发出来的软件能够一键切换中英文界面，就在这里把需要支持的语言勾上。Qt Creator会自动为每种选中的语言生成对应的翻译文件（.ts 文件），后续你只需往里面填入翻译文本即可。

如果目前只是学习和练手，默认选择“汉语”直接进入下一步就够了，后续项目中随时可以再添加其他语言支持。

2.1.7 配置Qt编译套件（Kit）

接下来这一步，是让编译器、调试器和Qt类库完成“会师”。默认情况下，列表中会显示你安装时勾选的编译套件，例如“Desktop Qt 5.14.2 MinGW 64-bit”。如果只装了这一套，直接用它就好；如果你配置了多个版本（比如同时装了MSVC和MinGW），可以在这里一并勾选。

所谓Qt套件（Kit），本质上是一个完整的战斗背包，它把从编译到调试需要的所有工具和库全部打包在一起：

• 编译器（g++）：把 C++ 代码翻译成机器码，并自动调用链接器。
• 基础类库：编译器运行所需的底层库。
• 调试器（gdb）：断点、单步、查看变量，排查 bug 全靠它。
• Qt 类库本身：专门配合该编译器编译生成的 Qt 框架库。

2.1.8 选择版本控制系统

这是新建项目的最后一步——项目管理界面。这里有两个可选项：

• 作为子项目：把当前项目挂载到另一个主项目之下，适用于大型工程的多模块管理。独立开发的小项目用不上。

• 版本控制系统：让你在项目创建的同时，把代码仓库纳入 Git等版本控制工具的管理。如果项目目录后续会关联GitHub或公司内部的Git仓库，可以在这里配置。

对于新手练手项目，这两个选项暂时都用不到，统一保持默认的<None>，直接点击右下角的“完成”即可。至此，一个崭新的Qt项目就建好了。Qt Creator会自动生成一套包含基础代码和配置文件的工程骨架，下一节我们就来看看这套骨架里每个文件分别扮演什么角色。

2.1.9 项目创建完成后的最终效果

经过上面八个步骤，一个全新的Qt项目就创建好了。看上去步骤不少，但别被这个“八步流程”吓住。实际上手几次之后，从头到尾建完一个项目，甚至用不了十秒钟。真正花时间的，是敲代码本身。

项目创建完成后，Qt Creator会自动切到代码编辑模式，屏幕中央会打开你新建项目的主界面文件，界面大致如下图。左边是项目文件树，中间是代码编辑器，右边是控件与属性面板，整个开发环境已经整装待发，等你来写第一行逻辑。

2.2 项目创建最佳实践

2.2.1 规范化创建Qt工程

如果你要用Qt写一个带图形界面的桌面程序，别犹豫，直接选Qt Widgets Application。这是Qt框架中最成熟、文档最丰富、社区积累最深厚的一类项目模板，传统桌面应用开发的首选，也是本文所有示例默认使用的项目类型。把它当成你的默认起点，写熟了之后再考虑其他模板。

qmake是老牌的Qt构建工具了：

在我们选择Qt Widgets Application之后，Qt Creator会为我们自动生成一套基础代码骨架,其中必然包含一个主窗口类。而这个步骤，就是在让你决定：这个自动生成的主窗口类，它倒底该继承自谁？换句说话，你要为即将诞生的窗口选择一个最合造的"父类"，因为这个父类决定了你生成的窗口天生自带哪些能力。

• 选QMainWindow：你得到的将是一个配置齐全的"框架窗口"。
• 选QWidget：你将得到一个最纯粹、最基础的"积木块"。
• 选QDialog：你将得到一个专门用来弹出对话的"对话框"。

有Git也可以选：

之前安装的时候就有选择安装编辑器，这里选择这个：

这是我们第一次接触Qt的开发环境，所以每一步都拆开讲得细了些。别被这页篇幅吓到，实际动手之后你会发现，熟练了建一个Qt项目从头到尾用不了30秒，一路Next到底就完事。第一次总要慢一点，后面自然就快起来了。

2.2.2 编译与运行项目

代码构建完成后，点击这个即可：运行按钮

三、深入认识Qt Creator开发界面

3.1 左侧功能栏——项目管理与开发辅助

在编辑模式下，Qt Creator 左侧竖排排列着两个窗口，官方称之为“边栏”。

• ① 项目文件管理窗口：以树形结构展示当前项目的所有源文件、头文件、界面文件和资源文件，是日常切换文件的核心入口。
• ② 打开文件列表窗口：列出当前已经打开的所有文件，方便在多个文件间快速跳转。

如果你觉得边栏占了太多屏幕空间，可以通过菜单栏“控件” → “Show Left Sidebar”，或者直接按快捷键Alt + 0，来控制它的显示和隐藏。

边栏里的窗口数量不是固定的。每个边栏子窗口的标题栏右侧都有一排小按钮——最右边是关闭按钮，倒数第二个是增加分栏按钮。点一下增加分栏，就能在边栏里再添加一个新的子窗口，比如把类视图、文件系统视图也挂进来，按自己的习惯自由拼装。

边栏子窗口标题栏的第一个控件是一个组合框，点击它可以切换该子窗口的功能视图类型，目前支持以下8种视图：

其中 项目、打开文档、类视图、大纲 是日常开发中最常打交道的四个视图，建议第一时间在边栏里固定好，形成自己的布局习惯。其余视图属于“按需启用”，用到时再切换出来也不迟。

3.2 代码编辑区——核心编码区域

编辑区上方的工具栏

在代码编辑区的正上方，有一排紧凑的工具栏，从左到右依次是：

①和②：返回/前进导航按钮 这两个按钮和浏览器的“后退”“前进”逻辑完全一致。当你从文件 A 跳转到文件 B，或者在同一个文件内从第10行跳到第100行，点“返回”就能回到刚才的位置。跨文件追踪函数调用链时，这两个按钮是效率神器,沿着调用链一路深入，想回到最初的起点，一直点“返回”就行。

③：文件读写状态标识 如果这里显示为“可写”，说明当前文件没有特殊保护，可以正常编辑。

④：文件类型图标

这个图标表明当前文件属于什么类型.cpp、.h、.pro等。它同时也是一个功能菜单的入口，点击可以弹出文件处理相关的扩展操作菜单。

⑤：打开文件名列表 这里列出了当前所有已打开的文档名称，点击可以快速切到目标文件，与边栏里的“打开文档”视图功能对应。

⑥：关闭当前文档

⑦：附加C++预处理指令 可以为当前文件额外注入临时的预处理宏，一般场景用不到。

⑧：选择符号 快速列出当前文件中所有函数、类、成员变量等代码符号，点击即跳转，与大边栏里的“大纲”视图功能一致。

⑨：光标位置 实时显示当前光标所在的行号和列号。

⑩：编辑区分栏 可以创建多个并排的编辑器窗口，方便同时对比两份代码，或分屏查看同一个大文件的多个不同位置。

行首区

编辑区左侧显示行号的那一窄条，就是行首区。它的作用远不止标注行号：

• 显示行号：最基础的功能。

• 断点标记：单击行号前面的浅灰色空白区域，可以直接在这行代码上打断点，出现一个红色圆点；再次单击取消断点。快捷键F9同样有效，调试时用得极频繁。

• 书签标记：右击行首区，在右键菜单里可以选择“切换书签”或“编辑书签”。书签方便在大型文件中快速定位关键行，快捷键是Ctrl + M。

断点和书签可以共存于同一行,打断点不碍书签，设书签也不影响断点，它们各管各的事，互不干扰。

编辑区：中间最大的一块区域就是编辑区，是日常写代码、改bug的核心地带。

3.3 UI 设计界面——可视化界面开发

在左侧项目文件管理窗口中，双击widget.ui文件，Qt Creator就会自动从编辑模式切换到设计模式。眼前不再是纯代码，而是一张可视化的画布——你可以直接从左侧的控件工具箱里把按钮、文本框、标签等部件拖拽到窗体上，所见即所得地搭建界面，布局、属性、样式全在这个界面里用鼠标完成。这是Qt开发中最爽的环节之一：UI的大框架靠拖拽搞定，细节逻辑再切回代码编辑器精修。

① 组件选择窗口 这里相当于一个部件仓库，按功能分类摆放，Layouts（布局器）、Buttons（按钮）、Display Widgets（显示控件）等。搭建界面时需要的各种标准部件，基本都能在这里找到。

② UI 设计窗口 这是你的画布。想往窗体上放什么，就从组件选择窗口找到对应的部件，直接拖拽过来，所见即所得。

③ 动作编辑窗口 由Action Editor 和 Signals & Slots编辑器两部分组成。Action Editor负责管理“动作”（如新建文件、保存、退出），并可通过拖拽将动作挂到菜单栏或工具栏上；Signals & Slots编辑器则支持在可视化界面上直接完成信号与槽的关联，不写一行代码就能搭好基本的交互逻辑。

④ 对象浏览窗口 以树形结构清晰展示当前窗体上所有组件之间的父子层级关系。每个组件都有两列信息：对象名（ObjectName）和它的类名。当界面复杂、控件堆叠时，这个视图是帮你理清控件归属最直观的方式。

⑤ 属性设置窗口 选中窗台上任意一个组件，这个窗口就会列出它所有的属性及当前取值，字体、大小、颜色、对齐方式等等，全部可以在这里直接修改。微调控件的样式和行为，基本都在这面板里完成。

3.4 构建区域——编译、调试与运行管理

Qt Creator左下角排布着四个按钮，这是你编译、运行和调试程序的总控制台。

第一个按钮是构建套件与目标类型选择器。它同时管两件事：用哪套Qt工具链来编译，以及编出 Debug 版本还是 Release 版本。

默认状态下，这里选的是Debug，包含完整调试符号，可以打断点、逐行跟踪、查看变量值，开发调试阶段就用它。当程序写完了、测试通过了、准备交付给用户时，点开这个按钮，在下拉菜单中切换为Release版本。Release版本会启用编译器优化、剔除调试信息，程序的体积更小、运行更快，但不能再被GDB逐行调试。

这个切换动作，在项目开发的收尾阶段必不可少。Debug用来找bug，Release用来交付上线，两者各有分工，养成发布前切到Release重新编译一遍的习惯，能避免不少生产环境的意外问题。

构建模式共有三种，各自定位清晰：

上面这张图对应的是只安装了一套Qt套件时的界面。如果你在安装时勾选了多套编译器（例如同时装了MinGW和MSVC），下拉列表中就会看到多行选项，每一行对应一套Kit，各自又都能独立选择Debug/Profile/Release模式。这种情况下，构建前先确认当前选中的套件和模式是否是你想要的那一组。

如果项目配置了多套可用的Qt套件，点开左下角第一个按钮后，下拉列表中会同时列出所有套件及其对应的Debug/Profile/Release构建类型。想切换套件或调整构建模式，选中目标条目，然后直接点击运行按钮即可。只要构建和运行过程没有报错，编译好的目标程序就会弹出界面。

另外三个按钮分别是：

• 第二个——运行按钮，快捷键Ctrl + R。如果项目还没构建过，或者代码刚做了修改，直接点运行，Qt Creator会先自动完成构建，再启动程序。开发过程中用得最勤的按钮，没有之一。

• 第三个——调试按钮，快捷键F5。点击后同样会自动触发构建，生成最新的目标程序，然后切到调试模式——断点、单步、变量查看全线上阵。

• 第四个——构建按钮，快捷键Ctrl + B。只做一件事：编译生成最新的目标程序，但不运行。只想检查代码能不能编过的时候用它。

这四个按钮正好构成一套日常开发循环：写完一段逻辑，先点构建看有没有编译错误；编过了就点运行看效果；出了bug 再点调试进去排查。循环往复，节奏紧凑。

3.5 Qt Creator使用技巧与开发建议

关键要点：form file

当直接双击ui文件，此时Qt Creator就会调用Qt Designer，打开ui文件，图形化的界面编辑器：

 ​​​​此时再点击左侧边栏的“编辑”按钮，此时显示的内容，就是.ui文件的本体了：

.pro：Qt项目的工程文件，也是qmake工具构建时候的重要依据

本文的内容到这里就全部结束了。

从界面的每个角落到构建区的按钮，我们一步步走完了Qt Creator的初识之旅。如果你是新朋友，感谢你的耐心阅读，希望这篇向导帮你跨过了Qt的第一道门槛；如果你已经和Qt打过照面，也谢谢你陪我们重走一遍基础，温故知新。

有任何疑问，随时在评论区留言。感谢你的阅读，下一篇见！