PIP 參數配置
本章節帶你更深入了解 pip 的配置機制,協助你在多重 Python 環境下避免套件衝突與權限問題。
使用方式
在 Linux/macOS 系統上,你可以使用以下指令來管理本地和全局配置:
python -m pip config [<file-option>] list
python -m pip config [<file-option>] [--editor <editor-path>] edit
其中,<file-option>
可以是以下選項:
--global
:指定作業系統全局配置文件。--user
:指定操作用戶級別配置文件。--site
:指定操作當前虛擬環境內的配置文件。
--editor
參數允許你指定一個外部編輯器的路徑。如果不提供此參數,則會依照 VISUAL
或 EDITOR
環境變數使用預設的文本編輯器。
例如:若想要使用 Vim 編輯器修改全局配置文件,可以使用以下指令:
python -m pip config --global --editor vim edit
提示
若你使用的是 Windows 系統,則配置檔可能位於 %APPDATA%\pip\pip.ini
,或使用 %HOMEPATH%\.pip\pip.ini
等路徑。可參考官方文件或使用 pip config list
進一步確認實際位置。
優先級
配置文件的優先級順序非常重要。以下是可能存在於你的機器上的配置文件列表,按優先級排序:
- 站點級文件:
/home/user/.pyenv/versions/3.x.x/envs/envs_name/pip.conf
- 用戶級文件:
/home/user/.config/pip/pip.conf
/home/user/.pip/pip.conf
- 全局級文件:
/etc/pip.conf
/etc/xdg/pip/pip.conf
在 python 環境中,pip 會按照上述順序來尋找並應用配置文件。
確認你正在修改的是正確的配置文件,可以幫助避免產生難以追蹤的錯誤。
配置文件範例
以下是一個配置文件的範例:
[global]
index-url = https://pypi.org/simple
trusted-host = pypi.org
pypi.python.org
files.pythonhosted.org
extra-index-url = https://pypi.anaconda.org/simple
這個配置文件中,各參數的意義如下:
index-url
:設定 pip 在安裝套件時使用的默認源。trusted-host
:列出無需使用 HTTPS 進行安全驗證的來源,以防出現 SSL 錯誤。extra-index-url
:提供額外的來源地址,用於搜索和安裝依賴套件。與index-url
不同,當需要的套件在index-url
指定的源中找不到時,pip 會尋找extra-index-url
。
注意
請注意,當使用多個源時,所有的源都應該是可信的,因為安裝過程中將會從這些源中選擇最適合的版本。未經信任的源可能會帶來安全風險。
提示
若你有私有套件伺服器,或需要指定帳號密碼進行驗證,也可以將帳密放在你的 pip.conf
中以利自動化,但務必確保檔案權限安全。