Python 3.9无法识别已安装第三方库的问题表现与成因

你遇到的这个报错根本不是pandas没装好，而是pip命令关联的Python解释器，和你当前执行导入操作时调用的Python解释器，根本不是同一个路径下的程序。
哪怕你亲眼在Python39的site-packages文件夹里看到了pandas的所有文件，只要当前运行的Python的模块搜索路径没指向这个文件夹，就一定会报ModuleNotFoundError。

排查步骤 #

先把两个关键路径查出来，别上来就反复卸载重装库浪费时间：

• 在你报ModuleNotFoundError的Python交互Shell（也就是你平时输import pandas的那个pyshell窗口）里执行两行代码，拿到当前正在用的Python程序路径和模块搜索路径：

  import sys
  print(sys.executable)  # 输出当前运行的python.exe的完整路径
  print(sys.path)         # 输出当前Python会搜索模块的所有文件夹路径
  

• 在你之前跑pip install pandas的Windows命令行里执行下面的命令，拿到当前pip关联的Python版本路径：

  pip --version
  

注：Windows系统如果开了应用商店的Python自动安装功能，哪怕你完全没主动装过Python，系统也会自带一个商店版的Python解释器，这个版本经常会和你手动安装的Python39抢命令行的调用优先级，是这类路径错配问题的最高发原因。

正常情况下你会看到两个路径完全对不上：比如pip实际关联的是c:\users\malth\appdata\local\programs\python\python39\python.exe，但你打开的交互Shell用的可能是微软商店版Python、Anaconda自带的Python，甚至是多年前装的旧版Python的交互窗口。

对应解决方法 #

根据你查到的实际路径匹配情况，选对应的方案就行，不用反复折腾：

• 如果你本来就想用当前打开的这个Python Shell跑代码
  别再用全局的pip install命令了，直接调用当前解释器自带的pip模块装库，在交互Shell里执行：

  import sys, os
  os.system(f'"{sys.executable}" -m pip install pandas')
  

  这种安装方式会直接把库装到当前解释器专属的site-packages路径下，从根源上避免路径错配，不会再出现装了找不到的问题。
• 如果你本来就是想使用Python39版本，只是打开错了交互环境
  直接导航到c:\users\malth\appdata\local\programs\python\python39\文件夹，双击里面的python.exe打开交互窗口再试导入就行；之前打开的错的交互窗口直接关掉。
• 如果你电脑装了多个Python版本导致PATH顺序错乱
  Windows系统会按照环境变量PATH里的路径顺序，优先匹配排在最前面的Python程序。你可以打开系统环境变量设置，把Python39的两个路径（根目录路径、根目录下的Scripts文件夹路径）移到PATH列表的最顶部，重启所有命令行和Python窗口之后，再用pip install就会正确把包装到Python39对应的路径下。

避坑提醒 #

• 不要认为“只要库文件存在于某个site-packages文件夹里，Python就一定能识别”：每个独立安装的Python解释器，只会加载自己专属路径下的site-packages模块，哪怕两个文件夹名字完全一样，路径不匹配也加载不到。
• 不要手动硬把site-packages的路径添加到sys.path里，这种操作很容易引发后续的模块版本冲突、依赖兼容报错，从根源上匹配解释器和pip的对应关系才是最稳妥的方案。

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