【Python】venv：配置独立镜像源

为某个特定的 venv 虚拟环境设置 pip 镜像源，使得该环境下的 pip 安装始终使用自定义镜像源，不影响系统 pip，也不依赖用户级配置文件。

环境准备

1. 创建虚拟环境

python -m venv venv

2. 激活虚拟环境

• Windows:

  .\venv\Scripts\activate
  

• Linux/macOS:

  source venv/bin/activate
  

配置镜像源

方法一：直接在虚拟环境中配置

1. 创建配置文件：

   • Linux/macOS:

     nano venv/pip.conf
     

   • Windows:

     notepad venv/pip.ini
     

2. 添加以下内容（以清华源为例）：

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

方法二：项目级配置

1. 在项目根目录创建配置文件：

   ./.config/pip/pip.conf  # Linux/macOS
   .\.config\pip\pip.ini   # Windows
   

2. 添加同样的配置内容

3. 设置环境变量指向该配置：

   • Linux/macOS:

     export PIP_CONFIG_FILE=./.config/pip/pip.conf
     

   • Windows:

     set PIP_CONFIG_FILE=.\.config\pip\pip.ini
     

验证配置

激活虚拟环境后执行：

pip config list

预期输出：

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

测试安装

pip install requests

观察下载源是否为配置的镜像地址。

配置优先级说明

pip 会按以下顺序查找配置：

1. PIP_CONFIG_FILE 环境变量指定的文件
2. 当前目录下的 pip.conf/pip.ini
3. 虚拟环境目录下的 pip.conf/pip.ini
4. 用户级配置（~/.pip/pip.conf 或 %APPDATA%\pip\pip.ini）
5. 系统级配置（/etc/pip.conf）

常用镜像源

镜像名称	URL
清华	https://pypi.tuna.tsinghua.edu.cn/simple
阿里云	https://mirrors.aliyun.com/pypi/simple/
腾讯云	https://mirrors.cloud.tencent.com/pypi/simple
华为云	https://repo.huaweicloud.com/repository/pypi/simple
豆瓣	https://pypi.doubanio.com/simple/

故障排除

如果配置未生效：

1. 确认虚拟环境已激活
2. 检查配置文件路径是否正确
3. 验证配置文件语法（特别是 Windows 的 .ini 格式）
4. 使用 pip config list -v 查看详细配置加载情况