為某個特定的 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 查看詳細配置加載情況