VS Code调试Python代码提示找不到Python模块但直接运行正常如何解决

问题原因 #

该报错的核心诱因是调试器调用的Python解释器和你直接运行代码时使用的解释器不匹配，常见触发场景如下：

• 开发工具的运行配置默认关联了可用的Python解释器，但调试配置绑定的是已删除的Python版本、不存在的虚拟环境路径
• 调试器的模块搜索路径未关联你正在使用的Python的标准库目录，json是Python内置标准库，只有解释器路径无效时才会出现找不到的情况
• 若你手动配置过调试启动参数，pythonPath等指向解释器路径的参数配置错误，指向了无效的可执行文件位置

修复方案 #

1. 确认可用解释器路径 #

先运行以下代码，获取你直接运行代码时正常生效的Python解释器绝对路径：

import sys
print(sys.executable)

2. 同步调试配置的解释器路径 #

根据你使用的开发工具调整对应配置：

• VS Code：按下Ctrl+Shift+P（Mac系统为Cmd+Shift+P），搜索「Python: Select Interpreter」，选择上一步输出路径对应的解释器即可，调试配置会自动同步该路径
• PyCharm：依次打开Run > Edit Configurations，找到对应Python调试项，在「Python interpreter」下拉列表选择对应路径的解释器
• 自定义launch.json配置：直接将配置中pythonPath字段的取值替换为第一步得到的绝对路径
  如果当前项目使用了虚拟环境，注意要选择虚拟环境目录下的Python可执行文件，不要选择全局Python解释器。

调整完成后重启调试器即可正常调试，不会再出现找不到模块的报错。

内容的提问来源于stack exchange，提问作者the review 77