
---

## 一、常见国内镜像源推荐

以下是一些稳定且速度优异的国内 PyPI 镜像源：

- **清华大学**  
    `https://pypi.tuna.tsinghua.edu.cn/simple`
- **阿里云**  
    `https://mirrors.aliyun.com/pypi/simple/`
- **中国科技大学（USTC）**  
    `https://pypi.mirrors.ustc.edu.cn/simple/` 
- **网易**  
    `https://mirrors.163.com/pypi/simple/`
- **豆瓣**  
    `http://pypi.douban.com/simple/`（推荐使用 HTTPS 若可用）

---

## 二、临时使用镜像方法（每次安装时添加）

在你激活的虚拟环境中，使用以下方式安装包时手动指定镜像源：

```bash
pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple
```

如果镜像为 HTTP，并提示“不受信任”，可额外加上 `--trusted-host` 参数：

```bash
pip install 包名 -i http://pypi.douban.com/simple --trusted-host pypi.douban.com
```


---

## 三、永久配置镜像（适用于当前虚拟环境）

若希望省去每次输入 -i 参数的麻烦，可以在虚拟环境中创建或修改配置文件，使 pip 默认使用国内镜像：

- **Unix / macOS 下虚拟环境：**  
    在虚拟环境目录下 `$VIRTUAL_ENV/pip.conf`
    
- **Windows 虚拟环境：**  
    在 `%VIRTUAL_ENV%\pip.ini`
    

在其中添加以下内容（以清华源为例）：

```ini
[global]
timeout = 120
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
```

- `timeout`：设置最长等待时间，例如 **120 秒**，避免连接中断 
    
- `index-url`：指定清华镜像为默认源
    
- `trusted-host`：将镜像主机设为可信，避免 HTTPS 以外的警告
    

记住，pip 配置的优先级如下（高到低）：

1. 虚拟环境中的配置
    
2. 当前用户目录中的配置
    
3. 全局配置（系统范围）
    

---

## 四、另一种永久配置方式：使用 pip config 命令

你也可以通过 pip 自带的命令来设置全局配置（不限于虚拟环境）：

```bash
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
```

随后你可以用 `pip config list` 来验证是否设置成功

若想恢复到默认的官方 PyPI 源，可使用：

```bash
pip config unset global.index-url
```


---

## 五、方式对比一览

|方式|优点|缺点|
|---|---|---|
|临时 `-i` 指定|简单快速，不改配置|每次需手动指定|
|虚拟环境配置|仅对该虚拟环境生效|需进入每个环境配置|
|全局配置|全局生效，无需重复配置|不够灵活，不适每个项目情况|

---

