pip¶
用法¶
python -m pip <command> [options]
py -m pip <command> [options]
說明¶
記錄¶
主控台記錄¶
pip 提供 -v, --verbose 和 -q, --quiet 來控制主控台記錄層級。預設情況下，某些訊息（錯誤和警告）在終端機中會以色彩顯示。如果您想要禁止彩色的輸出，請使用 --no-color。
檔案記錄¶
pip 提供 --log 選項，用於指定一個儲存最高詳細記錄的檔案。此選項預設為空值。此記錄會附加至之前的記錄。
與所有 pip 選項一樣，--log 也可以設定為環境變數，或置於 pip 設定檔中。請參閱 設定 區段。
--exists-action 選項¶
此選項指定路徑已存在時的預設行為。可能情況包括：下載檔案或檢出存放庫以進行安裝，建立封存檔。若未定義 --exists-action，pip 會在需要決策時提示。
- (s)witch
僅與 VCS 檢查相關。嘗試將檢查切換至適當的 URL 和/或版本。
- (i)gnore
中止目前的操作（例如不複製檔案、不建立封存檔、不修改檢查）。
- (w)ipe
在嘗試建立、下載或檢出新的檔案或 VCS 檢查之前，刪除檔案或 VCS 檢查。
- (b)ackup
將檔案或檢查重新命名為
{name}{'.bak' * n}，其中 n 是.bak副檔名之後的數字，因此檔案無法在某個時間點存在。因此，最近的備份將是.bak之後數字最大的備份檔。- (a)bort
中止 pip 並回傳非 0 離開狀態。
建置系統介面
這部分現在記載於 組建系統介面 中。
一般選項¶
- -h, --help¶
顯示說明。
(環境變數：
PIP_HELP)
- --debug¶
讓未處理的例外狀況在主次程式外傳播，而不是記錄到標準錯誤輸出中。
(環境變數：
PIP_DEBUG)
- --isolated¶
以隔離模式執行 pip，忽略環境變數和使用者設定。
(環境變數：
PIP_ISOLATED)
- --require-virtualenv¶
允許 pip 只在虛擬環境中執行；否則會傳回錯誤訊息而終止。
(環境變數：
PIP_REQUIRE_VIRTUALENV,PIP_REQUIRE_VENV)
- --python <python>¶
使用指定的 Python 詮釋器執行 pip。
(環境變數：
PIP_PYTHON)
- -v, --verbose¶
提供更多資訊。這個選項是可以累加的，最多可使用 3 次。
(環境變數：
PIP_VERBOSE)
- -V, --version¶
顯示版本並結束。
(環境變數：
PIP_VERSION)
- -q, --quiet¶
提供較少資訊。這個選項是可以累加的，最多可使用 3 次（對應到 WARNING、ERROR 和 CRITICAL 記錄層級）。
(環境變數：
PIP_QUIET)
- --log <路徑>¶
詳細揭露日誌附加的目錄。
(環境變數：
PIP_LOG、PIP_LOG_FILE、PIP_LOCAL_LOG)
- --no-input¶
停用輸入提示。
(環境變數：
PIP_NO_INPUT)
- --keyring-provider <鑰匙圈提供者>¶
如果允許使用者輸入，則透過鑰匙圈程式庫啟用憑證查詢。指定要使用的機制 [disabled、import、subprocess]。（預設：disabled）
(環境變數：
PIP_KEYRING_PROVIDER)
- --proxy <proxy>¶
以 scheme://[user:passwd@]proxy.server:port. 的格式指定 Proxy。
(環境變數：
PIP_PROXY)
- --retries <重試次數>¶
每次連線嘗試的最大重試次數（預設 5 次）。
(環境變數：
PIP_RETRIES)
- --timeout <秒>¶
設定 Socket 超時（預設 15 秒）。
(環境變數：
PIP_TIMEOUT、PIP_DEFAULT_TIMEOUT)
- --exists-action <動作>¶
路徑已存在時的預設動作：(s)witch、(i)gnore、(w)ipe、(b)ackup、(a)bort。
(環境變數：
PIP_EXISTS_ACTION)
- --trusted-host <主機名稱>¶
將此主機或主機：埠對標示為可信，即使它沒有有效或任何 HTTPS。
(環境變數：
PIP_TRUSTED_HOST)
- --cert <路徑>¶
PEM 編碼 CA 憑證組的路徑。如果已提供，則會取代預設值。進一步資訊，請參閱 pip 文件中的「SSL 憑證驗證」。
(環境變數：
PIP_CERT)
- --client-cert <路徑>¶
SSL 客戶端憑證路徑，為包含 PEM 格式私人金鑰和憑證的單一檔案。
(環境變數：
PIP_CLIENT_CERT)
- --cache-dir <目錄>¶
將快取資料儲存在 <目錄> 中。
(環境變數：
PIP_CACHE_DIR)
- --no-cache-dir¶
停用快取。
(環境變數：
PIP_NO_CACHE_DIR)
- --disable-pip-version-check¶
不要定期查看 PyPI，以確定是否有新版本的 pip 可供下載。已由 --no-index 暗示。
(環境變數：
PIP_DISABLE_PIP_VERSION_CHECK)
- --no-color¶
抑制有色輸出。
(環境變數：
PIP_NO_COLOR)
- --no-python-version-warning¶
對即將不支援的 Python 發出不建議使用警告時保持安靜。
(環境變數：
PIP_NO_PYTHON_VERSION_WARNING)
- --use-feature <功能>¶
啟用新的功能，可能與過往版本不相容。
(環境變數：
PIP_USE_FEATURE)
- --use-deprecated <功能>¶
啟用過時的函數，將會在未來移除。
(環境變數：
PIP_USE_DEPRECATED)