【Python】import 问题排查

Posted by 西维蜀黍 on 2019-11-23, Last Modified on 2021-09-21

解决思路

1

使用pip list查看本项目或者系统中已经安装了未找到的模块,这里具体又分为使用了 virenv 和未使用的情况。

2

直接在 terminal 中进入到当前工作文件夹(cd <your target folder>),测试以下 import:

$ python
Python 2.7.17 (default, Oct 24 2019, 12:57:47)
[GCC 4.2.1 Compatible Apple LLVM 11.0.0 (clang-1100.0.33.8)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>>import <your target module name>

Python是如何寻找包的

现在大家的电脑上很可能不只有一个Python,还有更多的虚拟环境,导致安装包的时候,一不小心你就忘记注意安装包的路径了。首先我们来解决找包的问题,这个问题回答起来很简单,但很多人不知道这个原理。假如你的Python解释器的路径是/bin/python,那么你启动Python交互环境或者用这个解释器运行脚本时,会默认寻找以下位置1

  1. /lib(标准库路径)
  2. /lib/pythonX.Y/site-packages(三方库路径,X.Y是对应Python的主次版本号,如3.7, 2.6)
  3. 当前工作目录(pwd命令的返回结果)

这里如果你用的是Linux上的默认Python,就是`/usr`,如果你是自己使用默认选项编译的,就是/usr/local。从上面第二条可以看到不同次版本号的Python的三方库路径不同,如果你把Python从3.6升级到3.7那么之前装的三方库都没法用了。当然你可以整个文件夹都拷贝过去,大部分情况不会出问题。

几个有用的函数

  • sys.executable 当前使用的Python解释器路径
  • sys.path 当前包的搜索路径列表
  • sys.prefix 当前使用的路径
>>> import sys
>>> sys.executable
'/home/frostming/.pyenv/versions/3.7.2/bin/python'
>>> sys.path
['', '/home/frostming/.pyenv/versions/3.7.2/lib/python37.zip', '/home/frostming/.pyenv/versions/3.7.2/lib/python3.7', '/home/frostming/.pyenv/versions/3.7.2/lib/python3.7/lib-dynload', '/home/frostming/.local/lib/python3.7/site-packages', '/mnt/d/Workspace/pipenv', '/home/frostming/.pyenv/versions/3.7.2/lib/python3.7/site-packages']
>>> sys.prefix
'/home/frostming/.pyenv/versions/3.7.2'

使用环境变量添加搜索路径

如果你的包的路径不存在上面列出的搜索路径列表里,可以把路径加到PYTHONPATH环境变量里,多个路径用:隔开(Windows用;)。

但需注意,避免把不同Python版本包的路径加到PYTHONPATH里,比如PYTHONPATH=/home/frostming/.local/lib/python2.7/site-packages,因为PYTHONPATH中的路径是优先于默认搜索路径,如果用Python 3的话会有兼容性问题。

顺便说下PATH是用来找可执行程序的搜索路径,假如你在终端中运行命令my_cmd,系统会依次扫描PATH中的路径,看my_cmd是否存在于该路径下,所以如果提示找不到程序或命令无法识别,那你就要看路径是否加到PATH里了。

Reference