Ubuntu 22.04下Qt程序标题栏异常，如何改为系统原生样式？

问题原因 #

官方二进制包的Qt默认未适配Ubuntu的GTK主题框架，缺少关联系统窗口装饰的依赖或配置；而Ubuntu官方源的qt6-base-dev是针对系统定制编译的，默认启用了原生主题支持。

解决方法 #

1. 安装系统主题依赖包 #

Ubuntu下Qt需要GTK相关库来对接系统主题，执行以下命令安装必要依赖：

sudo apt install libxcb-xinerama0 libgtk-3-dev qt6-gtk-platformtheme

2. 配置Qt使用GTK平台主题 #

临时测试（单次生效）

运行Qt程序时添加环境变量：

QT_QPA_PLATFORMTHEME=gtk3 ./你的程序名

永久生效

• 针对终端运行的程序：编辑~/.bashrc或~/.profile，添加以下内容：

  export QT_QPA_PLATFORMTHEME=gtk3
  

  执行source ~/.bashrc使配置立即生效。

• 针对Qt Creator中运行的项目：打开项目的Run设置，在Environment里添加环境变量：
  QT_QPA_PLATFORMTHEME=gtk3

3. 调整代码强制适配系统设置（可选） #

如果上述方法无效，可在项目代码中添加以下代码，让Qt自动读取系统桌面配置：

#include <QApplication>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    // 强制Qt遵循系统桌面设置
    QApplication::setDesktopSettingsAware(true);
    
    MainWindow w;
    w.show();
    return a.exec();
}

也可以指定使用Fusion或GTK样式：

a.setStyle(QStyleFactory::create("Fusion"));

4. 检查Qt Creator的Kit配置 #

打开Qt Creator的Tools > Options > Kits，选中你使用的官方Qt 6.5.2 Kit，确保：

• 环境变量中没有覆盖QT_QPA_PLATFORMTHEME的设置
• Qt版本路径指向正确的官方安装目录

内容的提问来源于stack exchange，提问作者Ngo Phu Hien