Linux下使用Qt开发图形界面应用的基本配置指南

1. 安装Qt开发环境

方法一：通过官方安装器安装

1. 下载Qt在线安装器： bash wget https://download.qt.io/official_releases/online_installers/qt-unified-linux-x64-online.run
2. 添加执行权限并运行： bash chmod +x qt-unified-linux-x64-online.run ./qt-unified-linux-x64-online.run
3. 按照向导安装Qt Creator和所需的Qt版本

方法二：通过包管理器安装（以Ubuntu为例）

sudo apt update
sudo apt install qtcreator qt5-default qmlscene qml-module-qtquick-controls2

2. 验证安装

安装完成后，验证Qt Creator是否正确安装：

qtcreator --version

3. 创建第一个Qt项目

1. 启动Qt Creator： bash qtcreator
2. 选择"File" → "New File or Project"
3. 选择"Application" → "Qt Widgets Application"
4. 按照向导完成项目创建

4. 基本开发工具配置

编译器配置

Qt Creator通常会自动检测系统编译器。如需手动配置： 1. 进入"Tools" → "Options" → "Kits" 2. 确保有可用的编译器（如GCC）和Qt版本

调试器安装

sudo apt install gdb  # Ubuntu/Debian
sudo yum install gdb  # CentOS/RHEL

5. 常用开发依赖

安装常用Qt模块的开发文件：

sudo apt install libqt5svg5-dev libqt5charts5-dev libqt5multimedia5-plugins

6. 项目配置示例

基本.pro文件示例

QT       += core gui widgets

greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

TARGET = MyFirstApp
TEMPLATE = app

SOURCES += main.cpp \
           mainwindow.cpp

HEADERS  += mainwindow.h

FORMS    += mainwindow.ui

7. 构建和运行

在Qt Creator中： 1. 点击左下角的"Build"按钮（锤子图标）构建项目 2. 点击"Run"按钮（绿色三角形）运行应用

或通过命令行：

qmake && make
./MyFirstApp

8. 打包应用

使用linuxdeployqt工具

1. 下载linuxdeployqt： bash wget https://github.com/probonopd/linuxdeployqt/releases/download/continuous/linuxdeployqt-continuous-x86_64.AppImage chmod +x linuxdeployqt-continuous-x86_64.AppImage
2. 打包应用： bash ./linuxdeployqt-continuous-x86_64.AppImage MyFirstApp -appimage

9. 常见问题解决

缺少OpenGL库

sudo apt install libgl1-mesa-dev

中文显示问题

在main.cpp中添加：

#include <QTextCodec>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QTextCodec::setCodecForLocale(QTextCodec::codecForName("UTF-8"));
    // ...
}

高DPI支持

在main.cpp中添加：

QApplication::setAttribute(Qt::AA_EnableHighDpiScaling);

10. 推荐学习资源

1. Qt官方文档：https://doc.qt.io/
2. Qt示例程序：安装后在/usr/share/qt5/examples/目录下
3. 《C++ GUI Qt4编程》书籍

通过以上配置，您已经可以在Linux环境下开始Qt图形界面应用的开发了。Qt Creator提供了强大的集成开发环境，支持代码补全、调试和UI设计等功能，可以大大提高开发效率。