PyQt6应用无法适配Mate桌面Numix Dark系统主题问题求助

云原生阿岚

2026-7-29

PyQt6应用在Mate桌面适配Numix Dark主题的解决方案

图片说明：带有计算器的图片为Numix Dark系统主题界面，带有按钮的图片为当前PyQt6应用界面。

问题：在Mate桌面环境下，PyQt6应用无法和其他适配Numix Dark主题的系统应用保持一致外观，已尝试搜索相关方案和配置Qt应用，但问题未解决。

现有代码

from PyQt6.QtWidgets import *
from PyQt6 import QtCore, QtGui
from PyQt6.QtGui import *
from PyQt6.QtCore import *
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("My App")
        button = QPushButton("Press Me!")

        # 设置窗口的中心部件
        self.setCentralWidget(button)
        print(QStyleFactory.keys())

app = QApplication(sys.argv)

window = MainWindow()
window.show()

app.exec()

解决步骤

1. 安装Qt6的GTK主题适配插件

Qt默认不会自动套用GTK主题，需要安装对应插件：

Debian/Ubuntu系：
```
sudo apt install qt6-style-plugins
```
Arch系：
```
sudo pacman -S qt6ct numix-gtk-theme
```

2. 强制Qt应用使用GTK主题

方法一：通过环境变量启动

在终端启动应用时添加环境变量，让Qt遵循GTK3主题：

QT_QPA_PLATFORMTHEME=gtk3 python3 your_app.py

如果希望永久生效，可以把export QT_QPA_PLATFORMTHEME=gtk3添加到~/.bashrc或~/.profile文件中，重启终端后生效。

方法二：在代码中指定风格

修改应用代码，直接设置使用GTK3风格：

app = QApplication(sys.argv)
# 检查可用风格后设置
available_styles = QStyleFactory.keys()
if "gtk3" in available_styles:
    app.setStyle(QStyleFactory.create("gtk3"))

运行代码时，print(QStyleFactory.keys())会输出当前可用的风格列表，如果没有gtk3，说明插件未安装成功，回到第一步重新操作。