VSCode中PySide6模块找不到问题求助（曾正常运行）

问题重现 #

在VSCode中运行PySide6项目时出现错误：

ModuleNotFoundError: No module named 'PySide6'

项目导入代码如下：

from PySide6.QtWidgets import QApplication, QMessageBox, QFileDialog
from PySide6.QtCore import QResource, QFile, QIODevice
from PySide6 import QtWidgets, QtCore

已尝试更新pip、重装/升级PySide6、更换运行方式，但问题依旧。

排查与解决方法 #

• 核对VSCode使用的Python解释器

  1. 查看VSCode左下角显示的当前Python解释器版本/虚拟环境名称
  2. 打开VSCode终端，输入pip show PySide6，查看输出的Location路径，确认该路径属于当前选中的解释器
  3. 如果路径不匹配，点击左下角的解释器选择器，切换到安装了PySide6的解释器（包括虚拟环境）

• 用指定解释器重新安装PySide6
  直接通过目标解释器的pip命令安装，避免版本冲突：

  # Windows
  python -m pip install --upgrade PySide6
  # macOS/Linux
  python3 -m pip install --upgrade PySide6
  # 虚拟环境下直接用pip
  pip install --upgrade PySide6
  

• 检查项目的VSCode配置
  打开项目根目录下的.vscode/settings.json，确保python.defaultInterpreterPath指向正确的解释器路径，示例：

  {
    "python.defaultInterpreterPath": "C:/Users/xxx/AppData/Local/Programs/Python/Python310/python.exe"
  }
  

• 重置VSCode解释器缓存
  按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板：

  1. 选择「Python: Select Interpreter」重新选中正确的解释器
  2. 选择「Developer: Reload Window」重启VSCode，让配置生效

• 排查多Python版本冲突
  如果系统中存在多个Python版本，确保使用对应版本的pip：

  # 针对Python3
  pip3 install PySide6
  # 或者指定具体版本
  python3.10 -m pip install PySide6
  

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