新版Python修改pip默认安装路径的方法与踩坑记录

 更新时间:2026年06月04日 09:30:28   作者:lrh122800  
pip安装的第三方库默认存放在C盘中,为了便于管理和不过度占用C盘空间,有些读者可能会想修改默认的pip路径,下面小编就和大家详细介绍一下具体的修改方法吧

前言

pip安装的第三方库默认存放在C盘中,为了便于管理和不过度占用C盘空间所以想修改默认的pip路径

修改pip文件下载模块的默认存储路径

pip.ini文件位置一般在C盘C:\Users…\AppData\Roaming\pip路径下,如果是刚配置的Python环境,则没有pip.ini文件,需要在执行完cmd指令之后才会生成,如果没有这个文件也可以手动创建该文件

我的电脑由于刚安装Python环境所以没有pip.ini文件,于是自己在C:\Users…\AppData\Roaming目录下新建pip目录并在该目录下创建pip.ini文件,具体如下图所示:

pip.ini文件内容:

[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
target=D:\Program Files\Python\Package\site-packages

index-url是设置第三方库的镜像源,设置镜像是为了更快下载,这里设置为阿里云镜像,当然也可以不设置或使用其他镜像

target是第三方库的目标安装路径,这个必须自己设置否则通过pip安装的第三方库依然安装在默认路径下,也可以在环境变量中设置一个PIP_TARGET变量,变量值为第三方库的目标安装路径,这两种方式是等价的

修改site.py文件

先查看pip默认路径

python -m site

由于还没有通过pip安装第三方库所以这里显示两个默认路径均不存在

查看site.py存放路径,site.py一般存放在Lib目录

python -m site -help

结果:

新版Python需要加入—user-site参数

python -m site ---user-site

下图是我的site.py文件存放的位置:

site.py需要修改两处,第一处修改位置:

修改后:

第二处修改位置:

修改后:

修改完site.py文件中后再输入python -m site -help查看存放路径并未修改完成

接下来设置USER_BASE环境变量,变量名为:PYTHONUSERBASE,值为USER_BASE的路径,如:D:\Program Files\Python\Package\Scripts

重新打开cmd命令查看,结果显示修改成功

修改了pip默认安装路径后安装的库无法被找到的问题

先尝试用pip安装matplotlib库:

已经成功安装在D:\Program Files\Python\Package\site-packages路径下:

但在cmd命令行输入pip show matplotlib结果显示没有这个包,但刚才已经安装成功,说明Python目前找不到我们自定义路径下安装的第三方库

在pycharm中也是这样:

为了解决这个问题只要以下两步即可:

1.将自定义安装路径添加到Python搜索库中

方法一:设置环境变量PYTHONPATH(不推荐使用)

PYTHONPATH环境变量用于指定Python的库搜索路径,因此可以将要添加的路径添加到PYTHONPATH环境变量中,变量名为:PYTHONPATH,值为修改的第三方库安装路径,如:D:\Program Files\Python\Package\site-packages

保存后无论在cmd命令行还是pycharm中均能找到安装在修改后位置的第三方库

但是如果使用Anaconda创建虚拟环境这样会导致Python的搜索路径中PYTHONPATH对应的路径优先级高于Anaconda中的路径,这会导致在Anaconda创建的虚拟环境运行程序时优先使用PYTHONPATH对应的路径下的库,从而因为版本问题报错,这样创建虚拟环境就失去意义,所以并不推荐这种方法

方法二:在Python搜索路径下添加.pth文件(推荐使用)

先查看一下当前Python搜索路径

python -m site

我这里是在D:\Program Files\Python\Package\Scripts\Python311\site-packages下添加一个mypath.pth文件,文件名没有要求,只要保证文件后缀是.pth就行

mypath.pth文件内容是你要添加的Python搜索路径,我的是D:\Program Files\Python\Package\site-packages:

再次查看一下Python搜索路径:

python -m site

可以看到自定义安装路径D:\Program Files\Python\Package\site-packages已经被添加到D:\Program Files\Python\Package\Scripts\Python311\site-packages之后

tips: 也可以将存放自定义安装路径的.pth文件放在其他已经存在的搜索路径下,但建议不要放在Anaconda路径之前否则会导致使用Anaconda虚拟环境时出现问题

2.查看是否添加成功

再次通过命令查看结果如下图:D:\Program Files\Python\Package\site-packages已经被加入库搜索路径

在cmd命令行输入pip show matplotlib显示安装位置为:D:\Program Files\Python\Package\site-packages,说明系统已经找到了我们刚才安装在自定义路径下的第三方库

在pycharm中也找到了matplotlib库

langchain 1.0+ 版本踩坑

langchain 1.0+ 版本对模块结构做了调整,PromptTemplate 不再直接放在 langchain.prompts 下,而是移到了 langchain_core.prompts 中(这是 1.0 版本的重大变更,看博主的时候很容易踩坑)。

所以

将原来的

from langchain.prompts import PromptTemplate

替换为 langchain 1.0+ 版本的正确导入方式:

# 1.0+ 版本的正确导入路径
from langchain_core.prompts import PromptTemplate

到此这篇关于新版Python修改pip默认安装路径的方法与踩坑记录的文章就介绍到这了,更多相关Python修改pip默认安装路径内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Python代码质量之从规范到自动化检查全过程

    Python代码质量之从规范到自动化检查全过程

    本文介绍了提高Python代码质量的十个关键方面,包括清晰的命名、一致性、注释、模块化、错误处理、测试、代码简洁、版本控制、性能优化和文档编写,需要的朋友可以参考下
    2026-05-05
  • Python sort 自定义函数排序问题

    Python sort 自定义函数排序问题

    这篇文章主要介绍了Python sort 自定义函数排序问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-09-09
  • python Socket之客户端和服务端握手详解

    python Socket之客户端和服务端握手详解

    这篇文章主要为大家详细介绍了python Socket之客户端和服务端握手,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-09-09
  • python pdb调试器及使用方法

    python pdb调试器及使用方法

    这篇文章主要介绍了python pdb调试器及使用方法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-06-06
  • Python Pandas分组聚合的实现方法

    Python Pandas分组聚合的实现方法

    这篇文章主要介绍了Python Pandas分组聚合的实现方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-07-07
  • 自己使用总结Python程序代码片段

    自己使用总结Python程序代码片段

    这篇文章主要介绍了自己使用总结Python程序代码片段,本文收集了如反向读取文件、往文件中所有添加指定的前缀、匿名函数作为返回值、将二进制数转为10进制数等实用代码片段,需要的朋友可以参考下
    2015-06-06
  • python使用urllib2模块获取gravatar头像实例

    python使用urllib2模块获取gravatar头像实例

    python使用urllib2模块获取gravatar头像的实例,大家参考使用吧
    2013-12-12
  • Python地理地图可视化folium标记点弹窗设置代码(推荐)

    Python地理地图可视化folium标记点弹窗设置代码(推荐)

    这篇文章主要介绍了Python地理地图可视化folium标记点弹窗设置,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-09-09
  • pandas factorize实现将字符串特征转化为数字特征

    pandas factorize实现将字符串特征转化为数字特征

    今天小编就为大家分享一篇pandas factorize实现将字符串特征转化为数字特征,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-12-12
  • Python的Pandas时序数据详解

    Python的Pandas时序数据详解

    这篇文章主要为大家详细介绍了Pandas时序数据,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2022-03-03

最新评论