VSCode调试器无法识别已安装Python模块，求助解决方案

核对终端与调试器的解释器路径 #

• 打开VSCode命令面板（Ctrl+Shift+P），输入Python: Select Interpreter，确认选中的解释器路径和终端中运行py -c "import sys; print(sys.executable)"输出的路径完全匹配。
• 若路径不一致，手动选择终端对应的解释器完整路径（比如终端输出C:\Python311\python.exe，就从选择列表中定位该路径）。

强制将模块安装到调试器对应环境 #

• 先获取调试器所用解释器的pip路径：在VSCode终端（确保已激活选中的解释器环境），运行where pip（Windows）或which pip（Linux/macOS），得到pip的完整路径。
• 用该pip重新安装模块，示例命令：C:\Python311\Scripts\pip.exe install --force-reinstall pyautogui

检查launch.json配置是否正确 #

• 打开.vscode/launch.json文件，确认python字段指定的解释器路径与选中的一致，示例配置：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "Python: Current File",
              "type": "python",
              "request": "launch",
              "program": "${file}",
              "python": "C:\\Python311\\python.exe"
          }
      ]
  }
  

• 若未指定python字段，VSCode会使用默认选中的解释器，但手动指定可避免环境歧义。

验证模块安装路径是否在调试器的sys.path中 #

• 在VSCode调试控制台运行import sys; print(sys.path)，查看输出路径是否包含pyautogui的安装目录（通常在Lib\site-packages下）。
• 若未包含，可在代码开头临时添加路径测试：import sys; sys.path.append("C:\\Python311\\Lib\\site-packages")（替换为你的site-packages实际路径），能正常导入则说明是路径配置问题，需检查环境变量或解释器的路径设置。

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