PYTHONPATH配置无效，Python如何引用本地自定的包

双非也想进大厂

已于 2022-02-19 18:12:46 修改

阅读量3.7k

点赞数 5

分类专栏： python 文章标签： PYTHONPATH IDE .pth文件 sys.path 模块导入

于 2022-02-18 00:53:31 首次发布

本文链接：https://blog.csdn.net/qq_43659823/article/details/122994767

版权

python 专栏收录该内容

2 篇文章

订阅专栏

当尝试在Python IDE中导入本地自定义模块时，直接修改PYTHONPATH可能无效，因为IDE可能会覆盖这个环境变量。为了解决这个问题，可以创建一个.pth文件，将其放入Python的site-packages目录下，文件内写入要添加的路径。这样，Python的sys.path将自动包含.pth文件指定的路径，从而能够成功导入模块。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在本地写了一个模块想要给其他本地模块使用。如果直接import，由于其不在sys.path 所包含的路径下，因此会报错找不到该模块。

修改PYTHONPATH是没用的

遇到这个问题，我们首先想到的当然是修改环境变量，将需要引用的目录添加到sys.path中。在查阅官方文档之后，我们会发现只需修改PYTHONPATH即可完成。但是，当我们把需要的路径添加到PYTHONPATH后会发现sys.path中依然没有添加的路径。

如上图，PYTHONPATH配置完毕

但是sys.path中没有PYTHONPATH的路径

问题的原因——PYTHONPATH被IDE使用了

通过如下代码获取PYTHONPATH的值

import os
env_dist = os.environ
env_dist.get('PYTHONPATH')

我们可以发现pycharm、IDLE和命令行获取的值完全不一样
在这里插入图片描述

其中只有命令行的值想我们期望的那样。以上现象基本可以断定在使用IDE时，它们会提供一个PYTHONPATH值覆盖掉系统的PYTHONPATH，可能是用来给自己的包提供路径。

解决方案，使用xxx.pth

那么本文给出一个可行的解决方案。大家可以在python安装目录下的site-packages文件夹（是安装目录的后代文件夹有好几层，实在找不到可以搜索一下）下添加xxx.pth文件，文件里面写上要添加的sys.pth里的目录。如下图所示
在这里插入图片描述
/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/site-packages

这样就可以像sys.path就会有pth文件中写的路径，从而import也可以正常使用了。