pip install加速下载镜像源
时间: 2025-05-24 09:49:07 浏览: 16
### 如何配置国内镜像源加速 `pip install` 的下载
#### 临时配置方法
可以通过命令行参数 `-i` 或者 `--index-url` 来指定镜像源地址,这种方式不会修改全局配置文件,仅对当前命令生效。例如,使用清华大学的镜像源安装某个包可以执行如下命令[^1]:
```bash
pip install some-package -i https://pypi.tuna.tsinghua.edu.cn/simple
```
#### 修改全局配置文件的方法
对于长期使用的场景,推荐修改 `pip` 的全局配置文件以永久保存镜像源设置。具体操作如下:
- **Windows 平台**: 配置文件路径为 `%APPDATA%\pip\pip.ini`。
- **macOS/Linux 平台**: 配置文件路径为 `~/.config/pip/pip.conf`。
如果上述文件不存在,则手动创建即可。在文件中添加以下内容并替换 `<mirror_url>` 为你选择的实际镜像站点地址[^3]:
```ini
[global]
index-url = <mirror_url>
```
例如,使用阿里云的镜像源时可写成:
```ini
[global]
index-url = https://mirrors.aliyun.com/pypi/simple
```
#### 环境变量法
另一种方式是通过设置环境变量 `PIP_INDEX_URL` 实现临时更改默认索引网址的目的。此方法适用于 shell 脚本或者自动化部署环境中动态调整 pip 源的需求。以下是具体的实现例子:
```bash
export PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
pip install some-package
```
---
#### 推荐的国内镜像源列表
为了方便用户选择合适的镜像源,这里列举了一些常用的 Python 包托管服务提供商及其对应的 URL 地址[^4]:
| 名称 | 镜像源地址 |
|--------------|---------------------------------------|
| 清华大学 | https://pypi.tuna.tsinghua.edu.cn/simple |
| 阿里云 | https://mirrors.aliyun.com/pypi/simple |
| 华东理工大学 | http://pypi.ecust.edu.cn/simple |
以上任意一个都可以作为 `<mirror_url>` 值填入前述提到的各种配置方案之中。
---
阅读全文
相关推荐


















