QtCreator Linux图形界面开发配置指南

1. 环境准备

1.1 安装必要软件包

在Ubuntu/Debian系统上：

sudo apt update
sudo apt install build-essential qtcreator qt5-default qt5-doc qt5-doc-html qtbase5-examples qtbase5-dev-tools

在CentOS/RHEL系统上：

sudo yum groupinstall "Development Tools"
sudo yum install qt-creator qt5-qtbase-devel

1.2 验证安装

qmake --version
qtcreator --version

2. QtCreator基本配置

2.1 首次启动配置

1. 启动QtCreator：qtcreator 或通过应用菜单
2. 首次启动会提示配置工具链，选择自动检测到的工具链
3. 确保检测到以下组件：
   • Qt版本 (如Qt 5.15.2)
   • 编译器 (如GCC)
   • 调试器 (如GDB)

2.2 配置构建套件(Kits)

1. 进入 工具 > 选项 > Kits
2. 检查自动检测到的套件是否完整
3. 确保：
   • 编译器设置为系统GCC
   • Qt版本设置为已安装的Qt版本
   • 调试器设置为系统GDB

3. 创建第一个Qt Widgets应用

3.1 新建项目

1. 文件 > 新建文件或项目
2. 选择 Application > Qt Widgets Application
3. 设置项目名称和位置
4. 选择构建套件(Kit)
5. 选择需要的模块(默认QtCore, QtGui, QtWidgets)

3.2 项目结构

典型项目包含：

项目名/
├── CMakeLists.txt 或 项目名.pro  # 构建文件
├── main.cpp        # 程序入口
├── mainwindow.cpp  # 主窗口实现
├── mainwindow.h    # 主窗口头文件
└── mainwindow.ui   # 主窗口UI设计文件

4. 界面设计

4.1 使用Qt Designer

1. 双击项目中的 .ui 文件打开设计器
2. 从左侧部件盒拖拽控件到主窗口
3. 使用属性编辑器调整控件属性
4. 使用布局管理器(Layouts)组织控件

4.2 常用控件

• 按钮: QPushButton
• 标签: QLabel
• 输入框: QLineEdit, QTextEdit
• 列表: QListWidget
• 表格: QTableWidget
• 组合框: QComboBox
• 单选/复选框: QRadioButton, QCheckBox

5. 信号与槽连接

5.1 在设计器中连接

1. 点击设计器上方的 编辑信号/槽 按钮
2. 从发送者控件拖到接收者控件
3. 选择信号和槽函数

5.2 代码中连接

在类构造函数中添加：

connect(ui->pushButton, &QPushButton::clicked, 
        this, &MainWindow::onButtonClicked);

6. 构建与运行

6.1 构建配置

1. 左下角选择构建配置(通常Debug或Release)
2. 点击 构建 > 构建项目

6.2 运行与调试

1. 点击 运行 按钮(绿色三角)启动程序
2. 使用 调试 按钮(带虫子的三角)进行调试
3. 断点设置：点击代码行号左侧区域

7. 常见问题解决

7.1 找不到Qt库

错误示例：

error: cannot find -lQt5Widgets

解决方案：

sudo apt install libqt5widgets5  # Ubuntu/Debian
sudo yum install qt5-qtbase-gui  # CentOS/RHEL

7.2 中文显示问题

在main.cpp中添加：

#include <QTextCodec>

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

7.3 高DPI支持

在main.cpp中添加：

QApplication::setAttribute(Qt::AA_EnableHighDpiScaling);

8. 进阶配置

8.1 添加第三方库

1. 在项目文件(.pro)中添加：

LIBS += -L/path/to/lib -llibname
INCLUDEPATH += /path/to/include

2. 或使用CMake的 find_package 和 target_link_libraries

8.2 国际化支持

1. 在代码中使用 tr() 包裹所有用户可见字符串
2. 使用 lupdate 工具提取字符串
3. 使用 Qt Linguist 翻译字符串
4. 使用 lrelease 生成.qm文件

8.3 部署应用

使用linuxdeployqt工具：

wget https://github.com/probonopd/linuxdeployqt/releases/download/continuous/linuxdeployqt-continuous-x86_64.AppImage
chmod +x linuxdeployqt-continuous-x86_64.AppImage
./linuxdeployqt-continuous-x86_64.AppImage your_app -appimage

9. 推荐学习资源

1. Qt官方文档：https://doc.qt.io/
2. Qt示例程序：/usr/share/qt5/examples (路径可能因系统而异)
3. 书籍：《C++ GUI Qt4编程》、《Qt5开发及实例》
4. 在线教程：Qt官方YouTube频道、Udemy Qt课程

通过以上配置和步骤，您应该能够在Linux环境下顺利使用QtCreator进行图形界面开发。