Windows10下Python3.10运行脚本提示No module named错误如何解决

所有之前正常运行的脚本统一报找不到模块，基本都是解释器路径错配导致的，按以下优先级逐一排查即可：

• 默认调用的Python解释器变更
  这是最高发的原因。你之前安装依赖时用的是某一个特定的Python实例（比如官网安装的本地版、虚拟环境内的版本、conda环境版本），但当前运行脚本时系统调用的是另一个完全独立的Python实例，自然读不到之前装的依赖。
  排查操作：打开你运行脚本用的终端，执行where python，会按优先级列出当前系统能找到的所有Python可执行文件路径，和你之前装依赖时用的Python路径做比对。如果路径不匹配，要么运行脚本时用对应解释器的完整路径启动，比如"C:\Program Files\Python310\python.exe" your_script.py，要么调整系统环境变量里的路径顺序，把你常用的Python3.10路径提到最前面。
• 虚拟环境未激活或已失效
  如果你之前的依赖都装在独立虚拟环境里，未激活虚拟环境就直接跑脚本，默认会调用全局Python，必然找不到虚拟环境内的包。
  排查操作：先执行对应虚拟环境的激活脚本，标准venv虚拟环境的激活命令是<你的虚拟环境目录>\Scripts\activate.bat，激活成功后终端行开头会显示带虚拟环境名称的括号前缀。如果激活后依然报错，打开虚拟环境目录下的pyvenv.cfg文件，检查home字段指向的路径是不是你当前Python3.10的安装目录——如果之前重装过Python、改动过Python安装文件夹位置，这个路径会失效，直接删除旧虚拟环境文件夹，重新创建虚拟环境后重装依赖即可。
• 环境变量被异常篡改
  如果近期安装过其他Python版本、卸载过开发类软件、手动修改过系统环境变量，或者Windows自动更新触发了路径重置，很可能把Python第三方库的site-packages路径从PYTHONPATH中移除，或是安全软件锁死了Python的库目录权限。
  排查操作：终端执行python -m site，查看输出的sys.path列表中是否包含Python3.10安装目录下的Lib\site-packages路径，如果缺失就手动把该路径添加到系统环境变量的PYTHONPATH条目中。同时检查Python安装目录、site-packages目录的权限，确认当前Windows登录账号有读取、执行权限，排除安全软件误隔离依赖文件的情况。
• pip与解释器不匹配
  部分场景下你调用的pip指令对应其他Python版本，导致包装到了别的版本的库目录里。
  排查操作：执行python -m pip list，查看输出的已安装包列表里是否有你需要的依赖，如果列表为空或者缺少对应包，直接用python -m pip install <缺失的包名>重新安装即可——这个指令会强制将包装到当前终端调用的Python解释器对应的库目录下，彻底避免pip和Python版本错配的问题。

特殊提示：Windows 10默认会将Microsoft Store版本的Python路径放在环境变量优先级顶部，如果你近期没有手动改过环境配置，优先检查是不是系统自动启用了Store版Python作为默认解释器，把自己安装的Python3.10路径优先级调到Store版路径前面就能解决。

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