配置用户pip源与查看当前的pip的源的办法

零、一个配置自己的pip源的办法

修改pip源，运行命令：

shell 复制代码

mkdir ~/.pip
gedit ~/.pip/pip.conf

将以下内容复制粘贴到pip.conf文件中。

txt 复制代码

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn

一、这几条命令在做什么？

mkdir ~/.pip

mkdir：创建目录（文件夹）的命令。
~：代表当前用户的 home 目录，比如 /home/你的用户名。
~/.pip：在你的 home 目录下创建一个名为 .pip 的隐藏目录。

作用：

在你的用户目录下新建一个专门放 pip 配置文件的文件夹。

gedit ~/.pip/pip.conf

gedit：图形化文本编辑器。
~/.pip/pip.conf：~/.pip 目录里的 pip.conf 文件。

如果这个文件不存在，gedit 会新建一个；存在就打开编辑。

作用：

打开（或创建）当前用户 pip 的配置文件：pip.conf，供你编辑。

pip.conf 中的内容含义

ini 复制代码

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple

[install]
trusted-host = pypi.tuna.tsinghua.edu.cn

这是一个 INI 配置格式文件，分为不同的"section"。

[global] 段

ini 复制代码

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple

[global]：全局配置，影响所有 pip 命令。
index-url：指定 pip 默认使用的 Python 包索引地址（包源）。
https://pypi.tuna.tsinghua.edu.cn/simple：清华大学 PyPI 镜像的 simple API 地址。

效果：

以后你在这个用户下运行：

bash 复制代码

pip install 包名

pip 不再去默认的官方源 https://pypi.org/simple，而是优先从清华镜像去下载包，通常在国内会更快、更稳定。

[install] 段

ini 复制代码

[install]
trusted-host = pypi.tuna.tsinghua.edu.cn

[install]：专门针对 pip install 行为的配置。
trusted-host：告诉 pip"这个主机是可信的"，不要因为证书或 HTTPS 问题而报错。

为什么要这样设：

某些镜像站的 HTTPS 证书或网络环境可能不那么完美，pip 有时会因为认证问题报错。
把域名 pypi.tuna.tsinghua.edu.cn 加为 trusted-host 能减少这类错误（但也意味着放宽一部分安全检查，前提是你信任清华镜像站）。

二、pip 的配置文件默认在哪？

pip 有 多级配置文件，按优先级从低到高大致有三类：

系统级（全局）配置
用户级配置
虚拟环境或当前目录的配置（较少用）

1. 常见位置（Linux / macOS）

用户级：
~/.pip/pip.conf 或
~/.config/pip/pip.conf
系统级（对所有用户生效，需 root 权限修改）：
/etc/pip.conf

你现在创建的 ~/.pip/pip.conf 就是用户级配置，只影响当前用户。

2. Windows 上的位置（顺便提一下）

如果你以后在 Windows 用 pip，大致是：

用户级：%APPDATA%\pip\pip.ini（通常类似 C:\Users\用户名\AppData\Roaming\pip\pip.ini）
全局：C:\ProgramData\pip\pip.ini（如果存在）

三、怎么查看当前 pip 实际使用的配置？

pip 自带命令可以帮你查看它现在在用哪些配置文件，以及最终生效的配置。

1. 查看所有被读取的配置文件路径

bash 复制代码

pip config list -v

这条命令会输出类似：

env_var : ...
global : /etc/pip.conf
user : /home/你/.pip/pip.conf 或 /home/你/.config/pip/pip.conf
site : 某个虚拟环境里的配置（如果有）

你可以在输出中看到 pip 实际读取的每一层配置文件路径。

2. 查看某个配置项的值

比如看现在 index-url 实际是什么：

bash 复制代码

pip config get global.index-url

如果配置正确，它会输出：

text 复制代码

https://pypi.tuna.tsinghua.edu.cn/simple

3. 列出所有生效配置

bash 复制代码

pip config list

会看到类似：

text 复制代码

global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'
install.trusted-host='pypi.tuna.tsinghua.edu.cn'

四、如何恢复或临时使用官方源？

临时使用官方源（只针对这一次命令）：

bash 复制代码

pip install 包名 -i https://pypi.org/simple

完全恢复默认源：

编辑你刚才的 ~/.pip/pip.conf，把 index-url 那行删掉或注释掉：
ini 复制代码
```
[global]
; index-url = https://pypi.tuna.tsinghua.edu.cn/simple
```
或者直接把 ~/.pip/pip.conf 重命名/删除：
bash 复制代码
```
rm ~/.pip/pip.conf
```

然后用 pip config list 或 pip config get global.index-url 再确认下。