命令列介面¶

使用直譯器 (interpreter) 的-m 來叫用命令列介面

最簡單可行的呼叫：

python-mensurepip

若pip 未安裝，此呼叫會將其安裝；否則甚麼也不做。可透過傳入--upgrade 參數來確保pip 的安裝版本至少為目前ensurepip 中最新可用的版本：

python-mensurepip--upgrade

預設上，pip 會被安裝至目前虛擬環境（若已啟動虛擬環境）或系統端的套件（若沒有啟動的虛擬環境）。安裝位置可透過兩個額外的命令列選項來控制：

--root<dir>¶

安裝pip 到給定的根目錄 (root directory) 的相對路徑，而不是目前虛擬環境（若存在）的根目錄，或目前 Python 安裝版所預設的根目錄。

--user¶

安裝pip 到使用者端的套件目錄，而不是全域安裝到目前的 Python 安裝版（此選項不允許在一啟動的虛擬環境中使用）。

預設會安裝pipX 和pipX.Y 腳本（X.Y 代表用來叫用ensurepip 的 Python 之版本）。安裝的腳本可透過兩個額外的命令列選項來控制：

--altinstall¶

若要求一個替代安裝版，則不會安裝pipX 腳本。

--default-pip¶

若要求安裝「預設 pip」，則會安裝pip 腳本，及 2 個常規腳本。

提供兩種指令選項將會導致例外 (exception) 。

模組 API¶

ensurepip 開放了兩個用於編寫程式的函式：

ensurepip.version()¶

回傳一個字串，用以標明初始建置時，安裝的 pip 的可行版本號。

ensurepip.bootstrap(root=None,upgrade=False,user=False,altinstall=False,default_pip=False,verbosity=0)¶

在目前或指定的環境之中建立pip。

root 指定一個替代的根目錄，作為安裝的相對路徑。若root 為None，則安裝使用目前環境的預設安裝位置。

upgrade 指出是否要將一個既有的較早版本的pip 升級至可用的新版。

user 指出是否要使用使用者的安裝方案而不是全域安裝。

預設會安裝pipX 和pipX.Y 腳本（X.Y 代表 Python 的目前版本）。

如果啟用了altinstall，則不會安裝pipX。

如果啟用了default_pip，則會安裝pip，以及 2 個常規腳本。

同時啟用altinstall 跟default_pip，將會觸發ValueError。

verbosity 用來控制初始建置操作內，對於sys.stdout 的輸出等級。

引發一個附帶引數root 的稽核事件ensurepip.bootstrap。

備註

初始建置的過程對於sys.path 及os.environ 均有副作用。改為在一子行程 (subprocess) 呼叫命令列介面可避免這些副作用。

備註

初始建置的過程也許會安裝pip 所需要的額外的模組，但其他軟體不應該假設這些相依 (dependency) 總是預設存在（因為這些相依很可能會在未來版本的pip 中被移除）。