pip install -e -v . 执行了什么？

运行命令 pip install -e -v . 会执行以下操作，逐步解析其中的含义：

1. pip install

这是 pip 工具的基本命令，用于安装 Python 软件包。

• 安装模式：
  • 从 Python Package Index (PyPI) 或本地路径中安装软件包。
  • 支持安装源码包、预构建的二进制文件（如 .whl 文件）、或直接从 Git 存储库安装。

2. -e

-e 是 pip install 的选项，表示可编辑模式（editable mode）。
在这个模式下，pip 不会直接将代码复制到 Python 的 site-packages 文件夹，而是会在安装目录中创建一个到项目源代码的符号链接。

• 用途：
  • 如果你在开发某个项目，希望实时修改源代码并立刻测试其效果，-e 模式非常有用。
  • 开发者可以在不重新安装的情况下更新项目代码。

3. -v

-v 是 pip install 的详细输出选项（verbose mode）。

• 效果：
  • 提供详细的日志信息。
  • 包括依赖解析、构建进程、安装路径、环境配置等信息。
  • 如果有多级依赖链，-v 还能展示这些依赖项是如何被解析和安装的。

4. .

. 表示当前目录。

• 含义：
  • pip 会在当前目录寻找 setup.py 文件或 pyproject.toml 文件。
  • 如果存在 setup.py，pip 会使用 setuptools 工具来安装当前目录下的项目。
  • 如果是现代化的 pyproject.toml，可能会使用 poetry 或 flit 等工具构建和安装。

 

总结：

运行 pip install -e -v . 时，具体执行的步骤包括：

1. 解析当前目录的项目：

   • 检查 setup.py 或 pyproject.toml，了解项目的依赖项和元信息。

2. 解析依赖并安装：

   • 解析项目中列出的依赖（如 install_requires）。
   • 下载或安装所有依赖项（如果尚未安装）。

3. 符号链接安装：

   • 在 Python 的 site-packages 文件夹中创建符号链接，指向当前项目目录。这样，项目代码的任何更改都会即时生效。

4. 输出详细日志：

   • 使用 -v 选项时，pip 会显示构建过程和安装过程的详细日志。

常见场景：

• 在开发一个 Python 包或应用时，用 -e 模式安装项目，方便随时调试和测试。
• 使用 -v 检查安装过程中是否出现错误或警告。
• 在本地路径安装非发布的 Python 项目。