在 Python 中切換鏡像源主要涉及 pip 包管理器 和 conda 環境(如 Anaconda、Miniconda) 的配置。國內訪問 Python 官方源(PyPI)可能較慢,因此推薦使用國內鏡像源(如阿里云、清華大學、豆瓣等)。以下是具體切換方法:
一、pip 更換鏡像源
1. 臨時使用鏡像源(單次命令)
在 pip install
命令中通過 -i
參數指定鏡像源:
pip install 包名 -i https://mirrors.aliyun.com/pypi/simple/ # 阿里云
pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple # 清華大學
pip install 包名 -i https://pypi.doubanio.com/simple/ # 豆瓣
2. 永久配置鏡像源
創建或修改 pip
配置文件:
# Linux/macOS:創建配置目錄
mkdir -p ~/.pip# 編輯配置文件(若不存在會自動創建)
nano ~/.pip/pip.conf
在配置文件中添加以下內容(以阿里云為例):
[global]
index-url = https://mirrors.aliyun.com/pypi/simple/[install]
trusted-host = mirrors.aliyun.com # 信任該鏡像源,避免 SSL 警告
保存后,所有 pip install
命令都會默認使用該鏡像源。
3. 常用國內鏡像源地址
鏡像源 | URL |
---|---|
阿里云 | https://mirrors.aliyun.com/pypi/simple/ |
清華大學 | https://pypi.tuna.tsinghua.edu.cn/simple |
中國科學技術大學 | https://pypi.mirrors.ustc.edu.cn/simple/ |
豆瓣 | https://pypi.doubanio.com/simple/ |
二、conda 更換鏡像源(適用于 Anaconda/Miniconda)
1. 添加鏡像源
# 添加清華鏡像
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/# 添加 conda-forge 社區源(可選,包含更多包)
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/# 設置搜索時顯示通道地址
conda config --set show_channel_urls yes
2. 查看配置結果
conda config --show channels
輸出應類似:
channels:- https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/- defaults
3. 恢復默認源
conda config --remove-key channels
三、驗證鏡像源是否生效
1. pip 驗證
pip install -vvv 包名 2>&1 | grep "Fetching" # 查看下載地址是否為鏡像源
2. conda 驗證
conda install 包名 # 安裝時觀察下載地址
四、注意事項
- 鏡像同步延遲:國內鏡像會定期同步 PyPI 官方源,但可能存在數小時的延遲。若遇到“找不到包”的問題,可臨時切換回官方源。
- 虛擬環境獨立配置:若使用虛擬環境(如
venv
、virtualenv
),配置文件路徑可能不同(如~/.virtualenvs/環境名/pip.conf
)。 - 優先使用官方源:若安裝特定版本的包遇到問題,可嘗試使用官方源:
pip install 包名 -i https://pypi.org/simple