Qt 5+ 專案報錯「QLabel: No such file or directory」.pro 配置修復

錯誤現象

Qt 5/6 專案編譯時提示：
QLabel: No such file or directory
或類似 QWidget、QPushButton 等 Widgets 模塊類找不到。

根因

Qt 5 將 GUI 組件從核心模塊剝離為獨立 widgets 模塊，.pro 文件需顯式聲明依賴。

一鍵修復

在專案 .pro 文件中添加：

greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

條件語法解析

• greaterThan(QT_MAJOR_VERSION, 4)：Qt 主版本號 > 4（即 Qt 5/6）時生效
• QT += widgets：鏈接 QtWidgets 庫，包含 QLabel、QWidget、QPushButton 等所有控件類

完整 .pro 示例

QT       += core gui
greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

TARGET = MyApp
TEMPLATE = app
SOURCES += main.cpp mainwindow.cpp
HEADERS += mainwindow.h
FORMS   += mainwindow.ui

常見模塊對照

添加該行後執行 qmake → 重新構建，錯誤即刻消失。