分享每一天-pip 使用国内镜像源

pip 使用国内镜像源

Python 1923 0 创建时间：2021-01-02 13:52:03

python pip 国内镜像

#### 1.简介
python 的 pip 工具可以很方便地管理第三方库，平时应该也经常使用  pip 进行第三方库安装，但通常情况下可能在国内的安装速度相对较慢。

本文给出几个常用的 pip 加速方法

#### 2、环境信息

MacOS 10.15.6
Python 3.8.5
pip3 20.2.3

#### 查看当前默认 index-url

你可以用如下命令来查看你当前环境默认使用的 index-url 即 pip 源地址：

```python
pip3 install --help | grep -A 4 '\--index-url <url>'
```

#### 单次指定 index-url 为国内源

为某次 pip 安装指定一个 index-url，使得本次安装的库及其依赖库都会从指定的 index-url 进行下载。命令如下：

```python
pip install {library_name} -i {index_url}
```

注：

(1) 这种方式只对单次安装生效，不会改变配置，也不会改变默认 index-url。这种方法适合简单使用 pip 或者某些特殊的场景，比如：自己开发的私有库托管在私有的源服务中；或者构建一个 docker 镜像时执行的 pip 依赖安装。

(2) 也可以对 pip install -r requirements.txt 生效，比如 pip install -r requirements.txt -i https://pypi.douban.com/simple

3、配置当前用户的 index-url 【推荐】

如果你想要当前用户始终使用指定的默认 index-url，则更改 pip.conf 中的全局配置是一个方法。

MacOS 当前用户的 pip 配置文件分以下几种情况：

(1) 如果当前用户通过 XDG_CONFIG_HOME 环境变量设置了 pip.conf 的位置，则该设置的 pip.conf 配置文件生效。

(2) 如果当前用户没有配置 XDG_CONFIG_HOME 环境变量，且 $HOME/Library/Application Support/pip/pip.conf 文件存在，则该配置文件生效。

(3) 如果上面两种情况均不存在，且 $HOME/.config/pip/pip.conf 文件存在，则该配置文件生效。

(4) 如果以上三种情况均不存在，且 $HOME/.pip/pip.conf 文件存在，则该配置生效。（此方法是较老的方法，虽然官网没宣布废弃，较新版本 pip 不建议）

推荐使用第三种方式，如果没有这个目录和文件，创建一个即可。

```python
➜  ~ pwd                                                 
/Users/huang
➜  ~ 
➜  ~ mkdir -p ~/.config/pip 
➜  ~ vim ~/.config/pip/pip.conf
```
添加内容如下

```python
[global] 
timeout = 60
index-url = https://pypi.douban.com/simple 
[install] 
find-links = https://pypi.douban.com
```
保存退出即可。

注：

(1) 这种方法配置的 pip.conf 只对当前用户的 pip 环境生效。

(2) 这种方法配置的 pip.conf 对当前用户下创建的所有虚拟环境也都生效（如果虚拟环境配置了单独的 pip.conf，则虚拟环境以 pip.conf 为准）

(3) 如果你只是设置 index-url，不需要其他设置，则可以使用如下命令设置，不过该方法要求 pip3 版本要 >= 10.0.0。

```python

pip3 install --upgrade pip -i https://pypi.douban.com/simple

pip3 config set global.index-url {index-url}
 
```
可以看到，当前最新版本 pip3 默认使用的用户配置文件位置是 $HOME/.config/pip/pip.conf，所以也推荐使用该位置的配置文件。

4、配置某个虚拟环境的 pip.conf

如果只想对某个虚拟环境的 pip 源，则只需要在虚拟环境的根目录下创建 pip.conf 文件并添加 index-url 配置。此方法与上面的配置相同，不再赘述。

或者在激活虚拟环境的情况下执行如下命令

```python
pip3 config set global.index-url {index-url}
```

5、配置所有用户的 pip.conf

配置所有用户的 pip.conf 与配置当前用户的 pip.conf 基本一致，过程不再赘述，但有几点需要提一下。

(1) 如果全局 XDG_CONFIG_DIRS 环境变量设置了 pip.conf 的位置，则该设置的 pip.conf 配置文件生效。

(2) 如果没有配置全局 XDG_CONFIG_DIRS 环境变量，且 /Library/Application Support/pip/pip.conf 文件存在，则该配置文件生效。

(3) 如果上面两种情况均不存在，且 /var/root/.config/pip/pip.conf 文件存在，则该配置文件生效。

(4) 如果以上三种情况均不存在，且 /var/root/.pip/pip.conf 文件存在，则该配置生效。（此方法是较老的方法，虽然官网没宣布废弃，较新版本 pip 不建议）

(5) 同样可以通过 pip3 的命令行来设置 index-url ，如下示例

➜  test-pip sudo -H pip3 config set global.index-url https://pypi.douban.com/simple
Writing to /var/root/.config/pip/pip.conf

可以看到，默认情况下，所有用户的全局 pip.conf 配置在 /var/root/.config/pip/pip.conf

注：所有用户的 pip.conf 配置都需要 sudo 操作，配置内容与给当前用户配置相同，且这种方法一般不推荐使用。

#### 附录参考：

1、pip configuration ref:

https://pip.pypa.io/en/stable/user_guide/#configuration
2、pip 官网文档

https://pip.pypa.io/en/stable/user_guide
3、pip 清华源文档帮助中心

https://mirrors.tuna.tsinghua.edu.cn/help/pypi/
4、pip 常用国内源

https://pypi.douban.com/simple    # 豆瓣源
https://pypi.tuna.tsinghua.edu.cn/simple    # 清华源
https://mirrors.aliyun.com/pypi/simple    # 阿里源

pip 使用国内镜像源

商品推荐

广告推荐

推荐文章