快捷導(dǎo)航

如何給pip更換國內(nèi)源并配置Python的國內(nèi)鏡像詳解

更新時間：2025年04月07日 11:28:33 作者：孽小倩

pip安裝的包都存在于外國的服務(wù)器上,速度會非常慢,可以給pip配置國內(nèi)鏡像,直接從國內(nèi)服務(wù)器安裝依賴,這篇文章主要介紹了如何給pip更換國內(nèi)源并配置Python的國內(nèi)鏡像的相關(guān)資料,需要的朋友可以參考下

前言

經(jīng)常搞 Python 開發(fā)的小伙伴們可能會遇到一個常見問題：使用 pip 安裝第三方庫速度太慢，甚至有時候還會超時，原因多半是因為我們默認(rèn)的 pip 源服務(wù)器在國外。為解決這類困擾，可以切換到國內(nèi)的鏡像源，享受更快的下載速度。今天這篇博客就來聊聊如何快速配置 pip 的國內(nèi)源。

溫馨提示：如果你是 Python 新手，可以先通過 python --version、pip --version 等命令確認(rèn)好自己的 Python 和 pip 版本再進行操作。

1. 為什么要切換國內(nèi)源？

下載速度更快：默認(rèn) pip 是從 Python 官方源（pypi.org）下載，網(wǎng)絡(luò)狀況不穩(wěn)定，常常會出現(xiàn)下載速度慢或失敗的情況。
穩(wěn)定性更高：國內(nèi)鏡像一般都在國內(nèi)服務(wù)器，連接更穩(wěn)定，出錯率也更低。
節(jié)省時間：加快依賴庫的安裝速度，在一定程度上能提高開發(fā)效率。

2. 常見的國內(nèi)鏡像源地址

這里列出幾家常用的國內(nèi)鏡像源，大家可以根據(jù)自己的需要進行選擇。

清華大學(xué) TUNA：https://pypi.tuna.tsinghua.edu.cn/simple
阿里云：https://mirrors.aliyun.com/pypi/simple/
豆瓣(douban)：https://pypi.douban.com/simple/
中國科學(xué)技術(shù)大學(xué)(USTC)：https://pypi.mirrors.ustc.edu.cn/simple/

3. 臨時使用國內(nèi)源

如果僅是臨時切換某一次安裝，那么使用命令行中的 -i 參數(shù)就可以了。比如你打算從清華源安裝 requests 庫，可以這樣做：

pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

這條命令僅在這一次安裝時生效，后續(xù)安裝依舊會恢復(fù)默認(rèn)的官方源。

4. 永久修改 pip 源

為了每次都能自動使用國內(nèi)鏡像，我們需要進行全局配置或用戶級配置。步驟相對簡單，以下展示三大系統(tǒng)的常用配置方式。

4.1 Windows 系統(tǒng)

創(chuàng)建配置文件Windows 下默認(rèn)的 pip 配置文件是 pip.ini 或者 pip.conf（不同 pip 版本可能稍有差異）。
- 通常建議放在：
```
C:\Users\<你的用戶名>\AppData\Roaming\pip\pip.ini
```
  如果沒有 pip 文件夾，可以手動創(chuàng)建。
寫入鏡像地址打開或者新建 pip.ini，寫入以下內(nèi)容：
```
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
```
這里的 trusted-host 是為了避免某些版本下會提示證書不被信任的問題。
驗證是否生效你可以在命令行里輸入：
```
pip config list
```
或者直接安裝一個庫試試看：
```
pip install flask
```
看看輸出的 Looking in indexes 是否變成了你配置的國內(nèi)源。

4.2 macOS / Linux 系統(tǒng)

在類 Unix 系統(tǒng)上（包括 macOS 和大多數(shù) Linux 發(fā)行版），pip 的配置文件默認(rèn)放置路徑通常為 ~/.config/pip/pip.conf 或者 ~/.pip/pip.conf。

找到或新建配置文件

# 進入 .config 文件夾
cd ~/.config
# 如果沒有 pip 目錄就創(chuàng)建一個
mkdir -p pip
# 進入 pip 目錄
cd pip
# 用你喜歡的編輯器來編輯 pip.conf，比如 nano、vi 或者其他
nano pip.conf

寫入國內(nèi)鏡像地址和 Windows 下類似，內(nèi)容格式相同：

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

保存并測試保存文件后，直接測試：
```
pip install flask
```
是否有 Looking in indexes 的提示。如果是你配置的國內(nèi)源，說明生效成功。

5. 使用多個鏡像源

有時候，我們可能會想要指定多個鏡像源來防止某一個源出現(xiàn)故障。pip 并不支持直接合并多個 index-url，但是你可以配合 --extra-index-url 的參數(shù)來使用額外的索引。例如，在命令行臨時使用：

pip install <庫名> --index-url https://pypi.tuna.tsinghua.edu.cn/simple --extra-index-url https://mirrors.aliyun.com/pypi/simple

這樣當(dāng)清華源上沒有找到對應(yīng)包時，會去阿里云再嘗試一次。

6. 常見問題與小技巧

pip 版本過舊
- 如果你的 pip 版本太老，可能不支持某些新特性，建議先升級：
```
pip install --upgrade pip
```
證書驗證不通過
- 可以加上 trusted-host，或者將其寫到配置文件中去。
- 如果實在不行，可以在命令行里加 --trusted-host pypi.tuna.tsinghua.edu.cn 之類的。
多環(huán)境沖突
- 有時候你可能有多個 Python 版本，或者用了 Anaconda、Miniconda。需要對每個環(huán)境的 pip 進行分別配置，或者使用環(huán)境專屬的 pip.conf。
- 也可以在虛擬環(huán)境中使用臨時指定源的方式安裝，不會影響全局。
Linux 系統(tǒng)權(quán)限問題
- 有時全局安裝需要 sudo，但也會導(dǎo)致一些權(quán)限問題。建議使用 --user 或者虛擬環(huán)境（如 venv）進行安裝，以免跟系統(tǒng)包沖突。

以上就是關(guān)于如何更換 pip 國內(nèi)源的簡單教程。總結(jié)一下，最關(guān)鍵的就是找到配置文件路徑，然后把 [global] 下的 index-url 改成國內(nèi)鏡像地址，就能享受更快更穩(wěn)定的下載速度啦。如果你是 Python 重度使用者，建議長期配置國內(nèi)源，既節(jié)省時間又不用每次手動敲命令。