Qt 是什么:框架概览与开发环境
认识 Qt 的模块划分与开发环境的搭建方法
#Qt 到底是什么
如果你已经写完本站的 C++ 基础篇,你手上已经有了类、继承、模板、STL 容器和智能指针这些工具。但你大概也发现了一件事:标准 C++ 至今没有官方的图形界面库。想写一个带按钮的窗口程序,标准库帮不上忙。Qt 就是来填补这个空缺的——它是一套跨平台的 C++ 应用程序开发框架。
但把 Qt 仅仅理解成"一个 GUI 库"是严重低估。Qt 真正的定位是一套应用开发框架:除了界面,它还提供了字符串与容器、文件与目录、网络(TCP/UDP/HTTP)、数据库、多线程、XML/JSON 解析、国际化、绘图与动画、串口与蓝牙等一系列现成设施。你可以完全不碰界面,只用 Qt 写一个后台服务程序;也可以只用它的界面部分。这种"大而全且内部一致"的特征,和 Java 生态很不一样:Java 的 GUI 有 Swing、JavaFX,网络有 Netty,JSON 有 Jackson,各自为政、风格各异;Qt 则像 Python 的"batteries included"哲学,所有部件出自同一套设计语言,命名、内存管理、错误处理的方式高度统一。
Qt 目前广泛应用于桌面软件(WPS、VirtualBox、剪映桌面版、Autodesk Maya)、嵌入式设备(车载中控、医疗仪器、工业 HMI)、以及大量企业内部工具。跨平台是它的核心竞争力:同一份源码,在 Windows、Linux、macOS 上分别编译就能得到原生观感的程序,不需要你为每种平台重写界面层。这一点比 Tkinter 强得多——Tkinter 虽然也跨平台,但控件是 Tk 自己绘制的,观感与原生系统明显脱节;Qt 在 Windows 上调用系统的主题绘制,在 macOS 上使用原生的窗口与菜单,看起来就是"本地程序"。
#模块划分:你需要链接什么
Qt 被切成若干个模块,每个模块是一个独立的库,按需链接。初学时最重要的是下面这几个:
- QtCore:所有非界面功能的底座。QString、QList、QMap、QFile、QTimer、QThread、信号槽机制本身都在这里。注意 QtCore 不依赖任何图形系统,纯控制台程序也会用它。
- QtGui:图形相关的底层:窗口系统集成、OpenGL、2D 绘图(QPainter)、字体、图像(QImage/QPixmap)、输入事件。
- QtWidgets:传统桌面控件库,QPushButton、QLabel、QMainWindow 等。它建立在 QtGui 之上。本书第三篇主要用这一套,也就是所谓的 Qt Widgets 技术栈。
- QtNetwork:TCP/UDP socket、HTTP 客户端、SSL。
- QtQuick / QML:另一套界面技术栈,用声明式的 QML 语言描述界面,逻辑仍用 C++。适合做动画丰富的现代界面(车载、移动端)。它是 Widgets 的"竞争对手",不是替代品。
- QtSql、QtXml、QtCharts、QtMultimedia 等:按名字望文生义即可。
这里有个容易混淆的点:Qt 6 之后 QtGui 与 QtWidgets 分得更彻底了。Qt 5 时代很多绘图类放在 QtWidgets 里,Qt 6 把它们归到了 QtGui。因此你在 Qt 6 里写绘图程序,可能只需要 Qt6::Gui 而不必链接 Widgets。
与前端做类比:QtCore 相当于 JS 语言本身加上标准库;QtGui 相当于浏览器提供的 Canvas 与 DOM 事件;QtWidgets 相当于一套现成的组件库(类似 Ant Design);QML 则更像 React/Vue 那种声明式写法。选择 Widgets 还是 QML,就像选择"用 jQuery 式命令式代码搭界面"还是"用 React 写组件"——前者代码直观、调试简单、适合工具型软件;后者表现力强、适合讲究视觉效果的界面。本系列从 Widgets 入手,因为它的心智模型更贴近你已经熟悉的 C++ 面向对象思维。
#Qt 5 还是 Qt 6
本系列统一使用 Qt 6(具体为 Qt 6.2 及以上)。Qt 6 于 2020 年底发布,是一次较大的架构升级:要求 C++17、引入新的图形渲染架构(RHI,可为不同平台选择 Vulkan/Metal/Direct3D 后端)、属性系统与容器类做了清理(比如 QVector 与 QList 在 Qt 6 中合并了)。
Qt 5 提示:Qt 5 中
QList和QVector是两个不同的类,Qt 6 把二者合二为一(现在的QList就是旧的QVector实现,旧的QList被移除)。另外 Qt 5 里QStringView、QMetaType等新设施还不完善,部分函数签名也有变化。如果你的工作环境只能用 Qt 5,本系列大部分代码依然可用,主要差别会出现在容器、CMake 命令名(Qt5::Core与Qt6::Core)以及少数被废弃的 API 上,我会用引用块标注。
#许可证
Qt 提供两种授权:商业许可(收费,可获得官方支持与某些专属模块)与开源许可(GPL v2/v3 或 LGPL v3)。对个人学习者而言关键结论是:用 LGPL 版本的 Qt 开发闭源商业软件是合法的,只要满足动态链接、不修改 Qt 源码、并提供 Qt 库的替换途径等条件。绝大多数桌面软件走的都是这条路。
需要提醒的是,Qt 公司近年在许可证上的说法有过调整,若你要在产品中使用,务必查阅官方最新条款或咨询法务。学习阶段完全不必纠结——下载开源版本,随便写。
#安装与 Qt Creator
Qt 的安装通过官方的在线安装器完成(从 qt.io 下载 qt-online-installer)。安装时会让你选择组件,建议勾选:
- Qt 6.x 下的 MinGW 或 MSVC(Windows)、macOS(Mac)、GCC 64-bit(Linux)三选一,取决于你的编译器;
- Qt Creator(官方 IDE,强烈建议装);
- CMake 与 Ninja(构建工具,安装器可顺带提供)。
Qt Creator 是 Qt 官方的集成开发环境,它不是必须的——你可以用 VS Code 写 Qt 代码然后用命令行编译。但 Qt Creator 有几个无可替代的便利:内置的可视化界面设计器(Designer)、QML 实时预览、对 .ui 与 qrc 资源文件的支持、以及开箱即用的调试器配置。初学阶段强烈建议直接用 Qt Creator,把精力放在学 Qt 本身而不是折腾构建配置上。
对比一下:Java 开发者习惯 Eclipse/IntelliJ + Maven/Gradle,Python 开发者用 PyCharm + pip。Qt 的处境更接近 C++ 的常态:构建系统(CMake)与 IDE(Qt Creator)是分离的,但 Qt Creator 对 CMake 的支持非常好,打开
CMakeLists.txt就能直接构建运行,体验接近"开箱即用"。
#第一个 Qt 项目:用 CMake 搭建
Qt 6 官方推荐(并且是默认)的构建系统是 CMake,取代了 Qt 5 时代自家的 qmake。CMake 需要知道三件事:去哪里找 Qt、要链接哪些模块、源码有哪些。下面是一个最小的完整 CMakeLists.txt:
cmake_minimum_required(VERSION 3.16)
project(HelloQt LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTOUIC ON)
set(CMAKE_AUTORCC ON)
find_package(Qt6 REQUIRED COMPONENTS Core Gui Widgets)
add_executable(HelloQt
main.cpp
)
target_link_libraries(HelloQt PRIVATE
Qt6::Core
Qt6::Gui
Qt6::Widgets
)配套的 main.cpp——这里先给一个"能跑起来"的最小版本,下一章会逐行剖析它:
#include <QApplication>
#include <QPushButton>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QPushButton button("点我");
button.resize(200, 80);
button.show();
return app.exec();
}命令行构建(假设源码目录结构如上):
cmake -S . -B build -DCMAKE_PREFIX_PATH=/Users/you/Qt/6.6.0/macos
cmake --build build
./build/HelloQtCMAKE_PREFIX_PATH 指向你的 Qt 安装目录下对应编译器套件的路径,这是 CMake 找到 Qt 的关键。如果你用 Qt Creator 打开 CMakeLists.txt,它会自动填好这个变量,你只需要点"运行"。
set(CMAKE_AUTOMOC ON) 让 moc 自动运行,AUTOUIC 把 Designer 生成的 .ui 文件转成头文件,AUTORCC 把 .qrc 资源文件编译进可执行文件。忘记开 AUTOMOC 是初学者最常踩的坑,表现为链接期报 "undefined reference to vtable"。
还有一个约定:Qt 内部统一使用 UTF-16 存储字符串(QString),源文件本身的编码建议统一为 UTF-8(现代编译器与 Qt Creator 默认如此)。中文字符串处理会在第 5 章详细展开。
命名规范落到代码上,大概长这样,你可以对照着感受一下 Qt 代码的"味道":
class Person : public QObject
{
Q_OBJECT
public:
explicit Person(QObject *parent = nullptr) : QObject(parent) {}
QString name() const { return m_name; } // getter 没有 get
void setName(const QString &name) { m_name = name; }
bool isAdult() const { return m_age >= 18; } // 布尔型 getter 用 is
void setAdult(bool adult) { m_age = adult ? 18 : m_age; }
private:
QString m_name;
int m_age = 0;
};
// 自由函数用小写 q 开头
qDebug() << person->name() << person->isAdult();Qt 5 提示:Qt 5 同样支持 CMake,但把
Qt6换成Qt5、Qt6::Core换成Qt5::Core即可。不过 Qt 5 项目更常见的是 qmake 的.pro文件:QT += widgets/SOURCES += main.cpp两行搞定。本系列不使用 qmake。
#命名与编码规范
Qt 的 API 有一套非常稳定、务必遵守的惯例,看懂它们能让你读代码的速度提高一倍:
- 类以
Q开头:QString、QWidget、QFile。这是 Qt 的"命名空间"替代品——早期 C++ 命名空间尚未普及时,Qt 用前缀避免冲突。 - 自由函数以
q开头:qDebug()、qAbs()、qobject_cast<>()。 - 枚举值通常不带类前缀但可读性很强:
Qt::AlignLeft、Qt::Horizontal。 - getter 不写
get:QWidget::width()而不是getWidth();QString::size()而不是getSize()。这一点与 Java Bean 规范(getXxx/setXxx)正好相反,刚从 Java 转过来会不习惯。 - setter 保留
set:setText()、setEnabled()。 - "是否"型 getter 用
is:isVisible()、isEnabled()。 - 成员变量在 Qt 自身源码中常用
m_前缀或d指针(Pimpl 惯用法),但你自己写代码不必强求,保持风格一致即可。
还有一个 Qt 特有的重要概念:Qt 不使用异常。整个框架几乎不 throw(少数例外如 QSqlError 相关),错误通过返回值(如 bool、nullptr)或 QIODevice 的 errorString() 表达。因此 Qt 风格的代码不应该用 try/catch 去包 Qt 调用。这与 Java 的"异常驱动"和 Python 的 EAFP 风格截然不同,习惯写 Python 的人容易在这里过度设计。
另外注意上面那段示例里 Person 同时用了 Q_OBJECT——这个宏是下一章元对象系统的入口,此处只是让你提前熟悉它的样子。
#小结
- Qt 是跨平台 C++ 应用框架,不只是 GUI 库;核心模块为 QtCore / QtGui / QtWidgets / QtNetwork / QtQuick。
- Widgets 是命令式的传统控件栈,QML/Quick 是声明式的新栈;前者更适合工具型桌面软件,本系列从 Widgets 入手。
- 本系列统一使用 Qt 6 + CMake,关键配置是
CMAKE_AUTOMOC/UIC/RCC与find_package(Qt6 ...)。 - Qt API 命名规律:
Q前缀类、q前缀函数、getter 无get。 - Qt 不用异常表达错误,别用
try/catch包裹 Qt 调用。
#练习
- 按本章的
CMakeLists.txt与main.cpp在你的机器上搭出第一个 Qt 项目,用命令行cmake -S . -B build构建并运行成功。 - 故意注释掉
set(CMAKE_AUTOMOC ON)和一个含Q_OBJECT的类(第 3 章会写),观察链接错误;再打开它,确认问题消失。写下你看到的错误信息。 - 查阅 Qt 官方文档的模块列表,写出 QtCharts、QtMultimedia、QtSerialPort 各自属于哪一类需求,并说明你会用它们做什么小程序。
- 对比思考:把你熟悉的 Java Swing 或 Tkinter 程序"用 Qt 重写",列出至少 3 处会因为 Qt 的设计(如对象树、信号槽)而写法大变的地方。