python - `--install-option=' --prefix '` and ` --root`和 `--target`之间的 pip (python)差异

Question

pip documentation 缺少太多措辞(在我看来)，关于处理源和目标的参数。

我在使用 pip3 安装 Sphinx 并使用可用选项似乎允许我将它精确地安装在我想要的位置时遇到了奇怪的事情(出于某些原因，我希望将每个东西都放在自己的目录中)。我说“玩”，并不是我没有阅读文档，也没有尝试过 --help ，而是因为 pip3 help install 没有帮助，而 pip install 官方文档页面在这方面太短了，实际上说的不超过 pip3 help install 。

这是完成的实验和观察结果。

第一种情况是 --root

我 downloaded the current Sphinx repository tarball ，解压，进入新创建的目录并做了:

pip3 install --root /home/<user-name>/apps/sphinx -e .

我虽然这与 --prefix 相同，因为没有明显可用的 --prefix 选项。令我惊讶的是，它将命令安装在 Python3 的 bin 目录中(也安装在本地自己的目录中)以及它的库目录中的一些东西，奇怪的是，我得到一个 /home/<user-name>/apps/sphinx 目录而不是 /home/<user-name>/apps/sphinx/home/<user-name>/apps/sphinx/… :它附加自身的指定路径。

最后一 pip 有什么意义？ --root的目的是什么？

第二种情况，--target

然后我虽然不是 --root ，那可能是 --target ，所以我做了(清理后):

pip3 install --target /home/<user-name>/apps/sphinx -e .  

它不起作用，提示无法识别的 --home 选项。

它提示的这个 --home(我没有指定)是什么，--target 到底是什么？

第三种情况，--install-option='--prefix=…'

在一些网络搜索和 StackOverflow 上的一个帖子之后，我尝试了这个:

pip3 install --install-option='--prefix=/home/<user-name>/apps/sphinx' -e .

它只是提示它无法安装 .pth 文件并且我的 PYTHONPATH 有问题，通过添加变量定义可以解决重新启动相同的问题:

export PYTHONPATH=/home/<user-name>/apps/sphinx/lib/python3.4/site-packages
pip3 install --install-option='--prefix=/home/<user-name>/apps/sphinx' -e .

即使在目录实际存在并且在其中安装任何内容之前，我也只需要设置 PYTHONPATH，但是这个没问题(在此过程中 pip 是否应该更新 PYTHONPATH 本身并提醒最终设置它，是有争议的问题)。

这个选项很好，但也不太明显。

最后一个相关的:

--editable 和 --src 有什么区别？

更新 #1

我不知道它是否与狮身人面像有关，但我注意到另外两件事。

在做

pip3 install --install-option='--prefix=<install-dir>' -e <repository-dir>

其中 repository-dir 是 Sphinx 的本地 check out ，Sphinx 安装在 install-dir 中，由 pip3 list 列出，但无法卸载。 p>

相反，做

pip3 install --install-option='--prefix=<install-dir>' Sphinx

也就是说，让pip3检索存档，Sphinx没有安装在install-dir中，而是安装在python目录中，由pip3 list列出，可以卸载。

根据源是本地存储库还是远程存档，它不会安装在同一位置，也不会或将是可卸载的。

依赖项不受影响，在两种情况下都以相同的方式处理(安装在预期的位置、列出的位置和可卸载的位置)。

更新 #2

--root 的行为让我感觉像是一种假根(就像你在构建 Debian 包或交叉编译时得到的那种)。如果它的意图是相同的，那么让我惊讶的路径恰恰相反，是预期的。

Answer 1

第一个也是显而易见的问题:为什么不直接从 PyPI 安装软件包？ ?

sudo pip install sphinx

如果你想安装任何带有 setup.py 的东西带有 pip 的文件您可以使用 --editable 标志:

-e, --editable <path/url>

Install a project in editable mode (i.e. setuptools “develop mode”) from a local project path or a VCS url.

所以你可以直接发出命令(如果需要，前缀为 sudo):

pip3 install -e /path/to/pkg

在哪里 /path/to/pkg是 setup.py 所在的目录可以找到(您提取文件的位置)。

回答其他问题:

1. --root <dir> 用于更改文件系统的根目录pip应该安装包资源，而不是改变在哪里找到包。

2. --target 用于告诉pip在哪个文件夹中安装包。

3. --install-option 用于设置setup.py 将使用的一些变量, 不改变 pip应该寻找文件。