Python pip配置文件路径与基础配置详解

木白

发布时间：2026-10-13| 6人浏览过

原创

本文详细列出了Linux、Mac OS及Windows系统下pip配置文件（pip.conf/pip.ini）的默认查找路径，并介绍了如何创建配置文件以指定国内镜像源、设置可信主机及禁用版本检查等常用全局配置项，帮助开发者优化Python包安装体验。

pip配置文件系统路径汇总

pip的配置文件可以存放在多个预设位置，系统会按优先级读取。

在Linux或Unix系统中：

/etc/pip.conf

~/.pip/pip.conf（注：实际环境中该路径可能不存在，需手动创建该文件夹及文件）

~/.config/pip/pip.conf

在Mac OS X系统中：

~/Library/Application Support/pip/pip.conf

~/.pip/pip.conf

/Library/Application Support/pip/pip.conf

在Windows系统中：

%APPDATA%\pip\pip.ini

%HOME%\pip\pip.ini

C:\Documents and Settings\All Users\Application Data\PyPA\pip\pip.conf（适用于Windows XP系统）

C:\ProgramData\PyPA\pip\pip.conf（适用于Windows 7及更高版本系统）

pip全局配置示例

pip配置文件支持多种全局配置项，以下是常见配置示例：

具体配置内容如下所示：


[global]
index-url = http://pypi.douban.com/simple #豆瓣源，可以换成其他的源
trusted-host = pypi.douban.com      #添加豆瓣源为可信主机，要不然可能报错
disable-pip-version-check = true     #取消pip版本检查，排除每次都报最新的pip
timeout = 120

以上关于Python pip源配置及配置文件存放位置的说明即为全部内容，供各位开发者参考，欢迎支持本站。