Qt是C++领域最成熟的跨平台GUI开发框架之一，它不光提供了丰富的界面控件，还自带信号槽、国际化、绘图系统等机制。对于刚接触C++ GUI编程的人，不必一上来就啃《C++ GUI Programming with Qt》全书，从可运行的最小例子出发更容易建立直觉。
一、开发环境与第一个窗口
在Ubuntu或Windows下，推荐直接安装Qt官方开源版在线安装包，勾选对应编译套件（如MSVC或GCC）以及Qt Creator。Qt Creator自带UI设计器，但入门阶段建议先用代码写界面，能更清楚每个类的作用。新建一个非Qt Designer项目，核心只需两个类：QApplication管理程序生命周期，QWidget作为窗口基类。
下面是一段最小可运行代码，它创建一个标题为“第一个Qt窗口”的空白窗口并显示出来。注意exec()会启动事件循环，只有退出循环程序才结束。任何Qt GUI程序都依赖这个循环来响应鼠标、键盘等事件。
#include <QApplication>
#include <QWidget>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
window.setWindowTitle("第一个Qt窗口");
window.resize(400, 300);
window.show();
return app.exec();
}
如果编译时报错找不到头文件，通常是项目文件（.pro）里漏写QT += widgets。Qt通过qmake或CMake管理模块，widgets模块包含了QWidget及其子类。新手常以为Qt核心只有QtCore，实际上界面部分必须显式引入widgets。
二、信号槽：Qt最核心的通信机制
信号槽是Qt区别于其他C++ GUI库的关键。控件在发生某些事情时发射信号（signal），开发者把信号连接到自定义函数或另一个控件的槽（slot）上。比如按钮被点击会发射clicked()信号，我们把它连到一个修改标签文字的函数，就实现了交互。
早期写法用SLOT宏，现代Qt支持函数指针形式，编译期就能检查类型。下方示例在窗口里放一个按钮和一个标签，点击按钮后标签文字改变。这种解耦方式让界面逻辑和底层处理分离，比回调函数更直观。
#include <QApplication>
#include <QWidget>
#include <QPushButton>
#include <QLabel>
#include <QVBoxLayout>
class DemoWindow : public QWidget
{
Q_OBJECT
public:
DemoWindow()
{
QVBoxLayout *layout = new QVBoxLayout(this);
label = new QLabel("初始文字", this);
btn = new QPushButton("点我改变", this);
layout->addWidget(label);
layout->addWidget(btn);
connect(btn, &QPushButton::clicked, this, &DemoWindow::changeText);
}
private slots:
void changeText()
{
label->setText("你点击了按钮");
}
private:
QLabel *label;
QPushButton *btn;
};
#include "main.moc"
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
DemoWindow w;
w.show();
return app.exec();
}
使用Q_OBJECT宏的类必须经过Qt的元对象编译器（moc）处理，所以上面代码里写了#include "main.moc"。若把类写在独立头文件，qmake会自动调用moc；写在main.cpp里就要像示例这样手动包含moc生成文件。忘记这一步是最常见的编译错误来源。
三、布局管理与常用控件
绝对定位（move+resize）在窗口缩放时会让界面错乱，Qt的布局管理器能自动适配。除了QVBoxLayout纵向排列，还有QHBoxLayout横向、QGridLayout网格。把控件交给布局后，无需关心像素坐标，Qt会在窗口大小变化时重新计算位置。
除了按钮和标签，QLineEdit接收单行文本，QTextEdit支持多行富文本，QComboBox提供下拉选择。这些控件都继承自QWidget，可以统一加入布局。下例展示了一个输入框加按钮，点击后把输入内容显示到标签。
#include <QApplication>
#include <QWidget>
#include <QLineEdit>
#include <QPushButton>
#include <QLabel>
#include <QHBoxLayout>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget w;
QHBoxLayout *lay = new QHBoxLayout(&w);
QLineEdit *edit = new QLineEdit();
QPushButton *btn = new QPushButton("提交");
QLabel *lab = new QLabel("等待输入");
lay->addWidget(edit);
lay->addWidget(btn);
lay->addWidget(lab);
QObject::connect(btn, &QPushButton::clicked, [&]() {
lab->setText(edit->text());
});
w.show();
return app.exec();
}
Lambda作槽函数在Qt5之后被支持，捕获列表里用引用要小心对象生命周期，本例中所有控件都在栈上且窗口未关闭前有效，所以安全。若用new创建且父对象正确设置，Qt的对象树会在父销毁时自动释放子对象，避免内存泄漏。
四、跨平台与中文显示避坑
Qt默认使用UTF-8源码，在Windows上用MSVC编译时，若源文件带BOM通常无碍，但用MinGW最好统一无BOM的UTF-8。中文乱码多半是编码不匹配，而不是Qt本身问题。可用QString::fromLocal8Bit处理老旧窄字符，但新项目建议全程QString与UTF-8。
另一个坑是资源文件（.qrc）。把图片、翻译文件放进qrc后，路径要以冒号开头，如":/icon.png"。这样编译进二进制，发布时不用带散落文件。下表列出入门常遇问题：
| 现象 | 原因 | 解决办法 |
|---|---|---|
| 按钮不显示 | 未调用show()或父窗口隐藏 | 确保顶层窗口show，子控件由布局管理 |
| 信号槽无反应 | 忘记Q_OBJECT或moc未运行 | 添加宏并重新生成构建文件 |
| 界面字体虚 | 高清屏未启用缩放 | 设置Qt::AA_EnableHighDpiScaling属性 |
掌握以上四点，已能写出基本桌面工具。下一步可了解QMainWindow的菜单栏、QDialog对话框，以及用Qt Designer拖拽生成ui文件，进一步提升开发效率。
QtC++GUI_programming修改时间：2026-08-03 16:33:34