首页·终端命令

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