首頁·終端機命令

pip install

套件與執行環境

用法

python -m pip install [-r requirements.txt] <package>

把套件裝進目前生效的那個 Python;用 python -m pip 呼叫可以避開 pip 其實屬於另一個解譯器的經典問題,而 PEP 668 之後系統 Python 會拒絕裝到虛擬環境之外。

常用選項

選項含義
-r <file>install everything a requirements file lists
-Uupgrade to the newest allowed version
-e .editable install of the project you are in
--userinto your home directory instead of the system
--no-depsthis package only, no dependencies
-c <file>apply a constraints file to the versions
--break-system-packagesoverride the PEP 668 refusal on a system python

範例

python -m pip install -r requirements.txt

installs a pinned set into the active environment

python -m pip install -U requests

upgrades one package

python -m pip install -e .

installs your own project so edits take effect at once

問題永遠是什麼裝到哪裡:裝進這個專案,還是裝到整台機器上。

怎麼看

  • 方括號 [ ] 表示這部分可以不寫。
  • 省略號 … 表示可以寫多個。
  • 選項區分大小寫——有些命令裡 -r 和 -R 不是一回事。

常見問題

Q. pip install 是做什麼的?

把套件裝進目前生效的那個 Python;用 python -m pip 呼叫可以避開 pip 其實屬於另一個解譯器的經典問題,而 PEP 668 之後系統 Python 會拒絕裝到虛擬環境之外。

Q. 怎麼寫?

python -m pip install [-r requirements.txt] <package> —— 方括號表示可以省略的部分。

Q. 值得記的選項有幾個?

這裡列了 7 個,完整列表在 man pip。這條命令屬於套件與執行環境。

相關命令

man 手冊: man pip-install