Windows环境下PySide6运行异常：依赖路径不匹配问题求助

一、安装路径异常 #

重装PySide6时发现主包位于全局Python目录，但其依赖包却安装在用户目录：

PS C:\Users\Owner\PyCharmProjects\InvestmentHunter> pip install PySide6
Requirement already satisfied: PySide6 in c:\python\lib\site-packages (6.5.2)
Requirement already satisfied: shiboken6==6.5.2 in c:\users\owner\appdata\roaming\python\python311\site-packages (from PySide6) (6.5.2)
Requirement already satisfied: PySide6-Essentials==6.5.2 in c:\users\owner\appdata\roaming\python\python311\site-packages (from PySide6) (6.5.2)
Requirement already satisfied: PySide6-Addons==6.5.2 in c:\users\owner\appdata\roaming\python\python311\site-packages (from PySide6) (6.5.2)

二、运行时报错信息 #

执行简单PySide6 GUI程序时触发导入错误：

Traceback (most recent call last):
  File "C:\Users\Owner\PyCharmProjects\InvestmentHunter\main.py", line 2, in <module>
    from gui import app
  File "C:\Users\Owner\PyCharmProjects\InvestmentHunter\gui.py", line 1, in <module>
    from PySide6.QWidgets import QApplication, QTableWidget,QTableWidgetItem
  File "C:\Python\Lib\site-packages\PySide6\__init__.py", line 124, in <module>
    _setupQtDirectories()
  File "C:\Python\Lib\site-packages\PySide6\__init__.py", line 58, in _setupQtDirectories
    for dir in _additional_dll_directories(pyside_package_dir):
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Python\Lib\site-packages\PySide6\__init__.py", line 27, in _additional_dll_directories
    raise ImportError(str(shiboken6) + ' does not exist')
ImportError: C:\Python\Lib\shiboken6\libshiboken does not exist

三、依赖包安装状态 #

单独安装shiboken6时，提示已存在于用户目录：

pip install shiboken6
Requirement already satisfied: shiboken6 in c:\users\owner\appdata\roaming\python\python311\site-packages (6.5.2)

四、测试代码 #

from PySide6.QWidgets import QApplication, QTableWidget,QTableWidgetItem
from PySide6.QGui import QColor

app = QApplication()

table = QTableWidget()
table.setRowCount(2)
table.setColumnCount(3)

table.show()

解决方案 #

• 彻底卸载所有相关包，清理全局和用户目录的残留：

  pip uninstall -y PySide6 shiboken6 PySide6-Essentials PySide6-Addons
  

• 手动删除残留文件夹：
  • 删除C:\Python\Lib\site-packages\PySide6目录
  • 删除C:\Users\Owner\AppData\Roaming\Python\Python311\site-packages下的shiboken6、PySide6-Essentials、PySide6-Addons文件夹
• 以管理员权限打开命令提示符，重新全局安装PySide6：

  pip install PySide6
  

• 验证安装路径一致性：
  执行以下命令，确认所有包的Location均指向全局Python目录：

  pip show PySide6 shiboken6 PySide6-Essentials
  

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