Python 3.9.1运行脚本时错误从3.8路径调取pip包的路径修正方法

• 前置排查：确认调用的解释器版本
  多数路径错配的根源是系统默认的python命令软链接指向Python3.8，只要启动脚本时调用的解释器本身是3.8版本，就必然优先加载3.8对应目录下的依赖。可在脚本第一行加入临时校验代码，确认实际运行的解释器路径：

  import sys
  print(sys.executable)
  

  如果输出结果不是3.9对应的可执行文件路径，直接使用3.9解释器的绝对路径启动脚本，例如/usr/local/bin/python3.9 your_script.py。

• 脚本内动态调整模块查找优先级
  在所有第三方库的导入语句之前，手动将正确的3.9依赖路径插入到sys.path列表的最高优先级位置，同时移除3.8的错误查找路径，示例代码：

  import sys
  # 将正确依赖路径提到查找顺序最顶端
  correct_pkg_path = "/usr/local/lib/python3.9/site-packages"
  if correct_pkg_path not in sys.path:
      sys.path.insert(0, correct_pkg_path)
  # 从查找列表中过滤掉所有3.8相关的路径
  sys.path = [p for p in sys.path if "python3.8" not in p]
  

  调整sys.path的代码必须放在所有第三方库导入语句的最前面，如果已经先导入了错误路径下的库，后续再修改查找路径不会对已加载的模块生效。

• 启动时通过环境变量临时指定查找路径
  不需要修改脚本代码的前提下，启动脚本时通过PYTHONPATH环境变量指定高优先级的依赖路径，命令格式：

  PYTHONPATH=/usr/local/lib/python3.9/site-packages /usr/local/bin/python3.9 your_script.py
  

  Python启动时会自动将PYTHONPATH指定的路径放到sys.path的最高优先级位置，覆盖默认的错误路径加载逻辑。

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