Python环境变量PYTHONPATH详解

迷途小书童

读完需要

4

分钟

速读仅需 2 分钟

大家好，我是迷途小书童！

今天来聊聊 PYTHONPATH。

PYTHONPATH 是一个环境变量，它是一个列表，列表的元素是目录，也就是一些文件夹的路径，它告诉 Python 解释器去哪些目录查找模块和包。python 会将这些路径加入到 sys.path 目录列表中，正确设置 PYTHONPATH 对于管理 Python 代码库和避免模块命名冲突非常重要。

1

PYTHONPATH的作用

不知道大家有没有注意到，我们在使用 pip 安装第三方库的时候终端的一些输出信息，比如这里的安装 ffmpy3

可以看到库是安装到了 c:\users\admin\anaconda3\lib\site-packages，这个目录也是安装库的默认位置。这时候我们 import ffmpy3，python 就会去上面这个路径去找 ffmpy3，如果没有找到，就会报错 ModuleNotFoundError: No module named 'ffmpy3'

有时候，我们自己写了一些代码，想要在其他模块中被导入并使用，但是这些代码并没有被安装到 c:\users\admin\anaconda3\lib\site-packages，这时候 PYTHONPATH 就派的上用场了，来看下面的示例，2 个 python 文件在同一级目录

# 模块mymodule.py


def func():
    print('mymodule')

# 使用上面的模块
# script.py


import mymodule


mymodule.func()

默认情况下，PYTHONPATH 是个空值

这时候去执行 script.py 的话，就会报错

$ python script.py
Traceback (most recent call last):
  File "script.py", line 1, in <module>
    import mymodule
ModuleNotFoundError: No module named 'mymodule'

现在我们来设置 PYTHONPATH，在 script.py 同级目录执行

export PYTHONPATH="$PWD"

然后再去执行 script.py 就可以看到 mymodule.py 中函数的输出了

2

路径列表

如果有多个要被导入的模块，这时候就需要添加多个路径到 PYTHONPATH，方法是类似的

cd ..
export PYTHONPATH="$PWD":$PYTHONPATH

如果要调整路径的顺利的话，可以将冒号前后的部分对调，即 $PYTHONPATH:$PWD

3

python 中获取 PYTHONPATH 值

使用 os.environ 来获取，其实所有的环境变量都可以通过它来获取

import os


os.environ['PYTHONPATH']

4

免费社群

作者：迷途小书童的Note