?? 學習目標

清晰掌握 Python pip.ini 配置文件的具體存放位置，了解其在 Windows 系統(tǒng)下的默認路徑、用戶級配置與全局配置的區(qū)別。能夠根據實際需求修改正確的配置文件，并驗證是否生效。

?? 核心重點

?? 一、pip.ini 配置文件的常見路徑（Windows）

?? 注意：以下路徑中 <用戶名> 表示你當前登錄系統(tǒng)的用戶名。

1. 用戶級配置文件（推薦使用）

適用于當前用戶的 pip 設置，不會影響其他用戶。

?? 路徑：

C:\Users\<用戶名>\pip\pip.ini

?? 如果該目錄不存在，請手動創(chuàng)建：

mkdir C:\Users\<用戶名>\pip
notepad C:\Users\<用戶名>\pip\pip.ini

2. 全局配置文件（影響所有用戶）

適用于整個操作系統(tǒng)的所有用戶。

?? 路徑：

C:\ProgramData\pip\pip.ini

?? 創(chuàng)建方法：

mkdir C:\ProgramData\pip
notepad C:\ProgramData\pip\pip.ini

?? 注意：此路徑可能需要管理員權限才能訪問和修改。

3. 虛擬環(huán)境專用配置文件

如果你使用了虛擬環(huán)境（venv），可以為每個項目單獨設置 pip 配置。

?? 路徑（假設你的虛擬環(huán)境名是 venv）：

<項目目錄>\venv\pip.ini

?? 示例：

notepad my_project\venv\pip.ini

?? 此配置只對激活該虛擬環(huán)境時的 pip 生效。

?? 二、如何查看當前生效的配置文件？

運行以下命令，可查看當前 pip 加載了哪些配置項及其來源：

pip config list -v

?? 輸出示例：

For user path: C:\Users\YourName\pip\pip.ini
global.index-url = 'https://pypi.tuna.tsinghua.edu.cn/simple'
global.trusted-host = ['pypi.tuna.tsinghua.edu.cn', 'files.pythonhosted.org']

?? 說明：

• For user path: 后面顯示的就是當前加載的配置文件路徑。
• 可幫助你確認是否修改了正確的文件。

?? 三、實戰(zhàn)：配置清華源并驗證是否生效

? 步驟 1：編輯用戶級 pip.ini 文件

打開或創(chuàng)建文件：

C:\Users\<用戶名>\pip\pip.ini

寫入以下內容：

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

? 步驟 2：驗證配置是否生效

運行命令查看當前配置：

pip config list -v

?? 如果看到如下輸出，則表示配置已成功加載：

global.index-url = 'https://pypi.tuna.tsinghua.edu.cn/simple'
global.trusted-host = ['pypi.tuna.tsinghua.edu.cn', 'files.pythonhosted.org']

? 步驟 3：測試安裝包是否走新源

pip install numpy

觀察下載地址是否來自清華源（部分包會顯示下載進度條中的 URL）。

?? 四、pip.ini 配置項詳細說明（按功能分類）

?? 注意事項

• ? 修改前建議備份原文件。
• ? 用戶級配置優(yōu)先于全局配置。
• ? 配置路徑中不要包含中文或空格，避免解析錯誤。
• ? 若使用公司網絡或代理，需正確配置 proxy 和 trusted-host。
• ? 配置日志文件時確保路徑存在且有寫權限。

?? 拓展練習（動手實踐）

• 查看當前生效的 pip.ini 路徑，并嘗試添加一個日志記錄路徑。
• 編寫一個腳本自動檢測當前 pip 是否配置了鏡像源，未配置則提示設置。
• 在 PyCharm 中配置解釋器使用你剛剛創(chuàng)建的虛擬環(huán)境，并測試安裝包是否走鏡像。
• 嘗試為不同項目創(chuàng)建多個虛擬環(huán)境，并分別為它們配置不同的 pip.ini 文件。
• 使用 pip config set 命令動態(tài)修改某個配置項，并驗證是否寫入配置文件。

?? 附錄：一鍵生成用戶級 pip.ini 文件的命令行方式

你可以直接使用命令快速創(chuàng)建 pip.ini 文件（替換 <用戶名>）：

echo [global] > C:\Users\<用戶名>\pip\pip.ini
echo index-url = https://pypi.tuna.tsinghua.edu.cn/simple >> C:\Users\<用戶名>\pip\pip.ini
echo trusted-host = pypi.tuna.tsinghua.edu.cn >> C:\Users\<用戶名>\pip\pip.ini
echo trusted-host = files.pythonhosted.org >> C:\Users\<用戶名>\pip\pip.in

到此這篇關于Python3 pip 配置文件（pip.ini）詳解：標準路徑 + 實操指南的文章就介紹到這了,更多相關Python3 pip.ini 配置文件內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論