如何查看并修改Python库的搜索路径？

本文共计602个文字，预计阅读时间需要3分钟。

根据前文内容，以下是简化后的开头内容：

使用pip install --user安装module库到用户packages路径中。我们知道Python中除了全局module lib路径外，还存在用户module lib路径。为了了解...

根据前文​​pip install --user 使用方法和注意事项——python中安装module库到用户packages路径中​​

我们知道python中除了自身的全局module lib路径以外还是存在用户module lib路径的，为了了解python中库的搜索路径我们需要知道python模块site.py 中的一些变量及使用方法。

​​site.​​​​getsitepackages​​() 获得python中全局site-package路径。

​​site.​​​​getusersitepackages​​() 获得python中用户的site-package路径。​

其中，site-package 为python中为第三方module lib安装提供的路径。

在使用 pip install xxx 时，是吧module lib安装到了全局的site-packages路径下的，在使用 pip install xxx --user 时是吧module lib安装到了用户的site-packages下面的。

这里举例：

windows平台下，python3.8版本，查看全局和用户 site-packages路径：

>>> import site

>>> site.getusersitepackages()

'C:\\Users\\81283\\AppData\\Roaming\\Python\\Python38\\site-packages'

>>> site.getsitepackages()

['C:\\Users\\81283\\anaconda3', 'C:\\Users\\81283\\anaconda3\\lib\\site-packages']

其中，site.USER_BASE 可以查看用户module lib的根目录。 site.USER_SITE可以查看用户 module lib的site-packages路径。

-----------------------------------------------------------------

更加全面的查看python中module lib的搜索路径：

python -m site

其中, sys.path 中是所有module lib的搜索路径，

USER_BASE, USER_SITE 已经上面介绍了。

ENABLE_USER_SITE: 用来表示是否启用用户下的module lib搜索路径，也就是当ENABLE_USER_SITE=True 时，并且C:\\Users\\81283\\AppData\\Roaming\\Python\\Python38\\site-packages 路径存在，此时sys.path中是有用户module lib搜索路径：C:\\Users\\81283\\AppData\\Roaming\\Python\\Python38\\site-packages的。

如果ENABLE_USER_SITE=False 或者 用户module lib搜索路径不存在，此时sys.path中是不出现C:\\Users\\81283\\AppData\\Roaming\\Python\\Python38\\site-packages的。

演示： 移除用户的 module lib搜索路径：

再次使用 python -m site 查看python所有的module lib搜索路径：

发现 sys.path中已经看不到用户module lib的搜索路径。

===============================================

如何为当前python环境添加新的module lib搜索路径呢？？？

在当前 sys.path 的所有可搜索路径下面添加 .pth 文件， .pth文件的文件名任意，这个主要看后缀名。在 .pth 文件中添加想要添加的新的 module lib搜索路径。

当前的 搜索路径：

在 sys.path 的任一路径下面创建 .pth 文件，如：

mypath.pth 文件内容：

再次查看 python 的 module lib搜索路径：

可以看到 .pth 文件中写的新的module lib路径已经添加到 sys.path 中。