在Linux系统上使用Qt开发图形界面应用，核心是要准备好Qt库、编译工具以及正确的项目配置。下面以Ubuntu和CentOS为例说明基本配置过程，并给出一个最简单的窗口程序示例。
一、安装系统编译工具链
Qt项目通常通过qmake或cmake构建，底层需要C++编译器。先安装基础开发工具：
- Ubuntu或Debian系：使用apt安装build-essential
- CentOS或RHEL系：使用yum安装gcc-c++和make
# Ubuntu / Debian sudo apt update sudo apt install -y build-essential # CentOS / RHEL sudo yum groupinstall -y "Development Tools"
二、安装Qt开发库
如果不想用官方的Qt在线安装器，可以直接通过系统仓库安装Qt开发包，这样依赖处理最简单。
Ubuntu安装Qt5示例
sudo apt install -y qtbase5-dev qtbase5-dev-tools qttools5-dev-tools
CentOS安装Qt5示例
sudo yum install -y qt5-qtbase-devel
三、验证qmake可用性
安装完成后，在终端输入以下命令，能打印版本信息即说明配置正常：
qmake --version
若提示命令未找到，请检查是否安装了qtbase5-dev-tools包，或手动将Qt的bin目录加入PATH。
四、创建第一个Qt窗口应用
下面用一个最小可运行例子展示如何写代码、写工程文件并编译运行。
项目文件 hello.pro
QT += widgets TARGET = hello TEMPLATE = app SOURCES += main.cpp
源码 main.cpp
#include <QApplication>
#include <QLabel>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QLabel label("Hello Qt on Linux");
label.show();
return app.exec();
}
编译与运行
qmake make ./hello
五、常见配置问题
| 问题现象 | 可能原因 | 处理方式 |
|---|---|---|
| 找不到<QApplication> | 未安装widgets模块开发包 | 安装qtbase5-dev或qt5-qtbase-devel |
| qmake命令不存在 | 工具包未装或PATH未配置 | 安装qtbase5-dev-tools并刷新终端 |
| 界面无法启动 | 缺少图形后端依赖 | 确认系统已安装xorg或wayland基础库 |
六、使用CMake替代qmake
现代Qt项目也常用CMake管理。基本CMakeLists.txt写法如下：
cmake_minimum_required(VERSION 3.5) project(hello LANGUAGES CXX) find_package(Qt5 REQUIRED COMPONENTS Widgets) add_executable(hello main.cpp) target_link_libraries(hello Qt5::Widgets)
配置好以上环境后，就可以在Linux下顺利开发Qt图形界面应用了。遇到库缺失时，优先用发行版仓库安装对应-dev或-devel包，能避免大部分链接错误。
LinuxQtGUI_development修改时间：2026-07-27 02:09:20