Linux下Pip安装的PySide/PyQt无法加载系统样式的解决求助

问题原因 #

通过Pip/Poetry安装的PySide6是预编译的通用二进制包，默认仅包含Windows和Fusion两种跨平台风格，不会自动识别系统安装的Qt6风格插件（比如Adwaita）。

解决方案步骤 #

1. 安装系统Qt6 Adwaita风格插件

在Ubuntu终端执行以下命令，安装Qt6的Adwaita风格适配包：

sudo apt install qt6-style-plugin-adwaita qt6-gtk-platformtheme

这两个包分别提供Adwaita风格定义和GTK平台主题支持，确保Qt能对接系统主题。

2. 让PySide6加载系统插件并应用Adwaita主题

有两种方式实现，选其一即可：

方式一：通过环境变量配置（运行前设置）

在启动应用前，先设置环境变量：

export QT_QPA_PLATFORM=gtk3
export QT_STYLE_OVERRIDE=adwaita
# 然后运行你的应用
python your_app.py

方式二：在代码中动态配置（推荐，无需每次手动设环境变量）

在应用初始化代码最开头添加以下内容：

import os
from PySide6.QtCore import QCoreApplication
from PySide6.QtWidgets import QApplication, QStyleFactory

# 添加系统Qt6插件路径（Ubuntu下默认路径）
system_qt_plugin_path = "/usr/lib/x86_64-linux-gnu/qt6/plugins"
QCoreApplication.addLibraryPath(system_qt_plugin_path)

# 设置平台主题为GTK3，强制使用Adwaita风格
os.environ["QT_QPA_PLATFORM"] = "gtk3"
os.environ["QT_STYLE_OVERRIDE"] = "adwaita"

# 初始化应用
app = QApplication([])

# 验证风格是否加载成功（可选）
print(QStyleFactory.keys())  # 输出应包含'adwaita'

# 应用Adwaita风格
app.setStyle(QStyleFactory.create("adwaita"))

# 后续的UI代码...

3. 验证效果

运行应用后，界面会自动匹配Ubuntu的Adwaita主题风格，包括窗口装饰、按钮、菜单等控件的样式。

内容的提问来源于stack exchange，提问作者enduser