[python]pyenv工具之shims

问题:通过pyenv工具和插件创建的虚拟环境, 激活环境之后, 执行命令which pip, 为什么是在.pyenv/shims下, 而不是具体的虚拟环境下的bin目录下

这是因为pyenv通过shims机制来管理命令。当使用pyenv安装Python时，它会为每个可执行文件（如python、pip等）创建一个shim（垫片），这些shim位于~/.pyenv/shims目录中。当执行命令时，shim会决定使用哪个版本的Python或工具。

使用pyenv-virtualenv等插件创建虚拟环境后，激活环境时，pyenv会通过设置环境变量（如PYENV_VERSION）来告诉shim应该使用哪个环境。因此，当执行which pip时，会显示shim路径，但实际上shim会转发命令到当前激活的虚拟环境下的bin目录。

具体过程：

1. 安装pyenv后，会在~/.pyenv/shims目录下为每个可执行命令创建shim。
2. 当执行一个命令（如pip）时，shim会根据当前设置的版本（通过pyenv local、pyenv global或pyenv shell设置，或者通过虚拟环境激活设置）来调用对应版本的命令。
3. 激活虚拟环境后，pyenv会设置相应的环境变量，使得shim能够找到虚拟环境中的可执行文件。

所以，which pip显示的是shim的路径，因为shim是第一个在PATH中找到的。但是，这个shim会正确地调用虚拟环境中的pip。

如果想查看实际pip的路径，可以使用pyenv which pip命令，它会显示当前激活环境下pip的实际路径。

示例：

假设有一个虚拟环境名为myenv，激活后执行：
$w\; h\; i\; c\; h\; p\; i\; p\; /\; h\; o\; m\; e\; /\; u\; s\; e\; r\; /\; .\; p\; y\; e\; n\; v\; /\; s\; h\; i\; m\; s\; /\; p\; i\; p\; which\; pip\; /home/user/.pyenv/shims/pip$whichpip/home/user/.pyenv/shims/pip pyenv which pip

/home/user/.pyenv/versions/myenv/bin/pip

因此，虽然which显示的是shim，但实际执行的是虚拟环境中的pip。

这是一个非常好的问题，涉及到 pyenv 的核心工作原理。让我详细解释一下：

pyenv 的 shims 机制

pyenv 使用 shims（垫片） 作为命令转发层，这是它的核心设计：

1. shims 目录结构：

   ~/.pyenv/shims/
   ├── python
   ├── pip
   ├── pip3
   └── ... 其他命令

2. PATH 优先级： pyenv 将 shims 目录放在 PATH 的最前面：

   $ echo $PATH
   /home/user/.pyenv/shims:/usr/local/bin:/usr/bin:...

为什么 which pip 显示的是 shim

当您执行 which pip 时，系统会按 PATH 顺序查找：

1. 首先找到 ~/.pyenv/shims/pip
2. 这是最先匹配的，所以显示这个路径

shim 的工作原理

每个 shim 实际上是一个小脚本，它会：

1. 检查当前环境状态
2. 确定应该使用哪个 Python 版本/虚拟环境
3. 将命令转发到正确的实际位置

示例 shim 内容（简化）：

#!/usr/bin/env bash
# ~/.pyenv/shims/pip

# 1. 确定当前激活的环境
if [ -n "$PYENV_VERSION" ]; then
    VERSION="$PYENV_VERSION"
elif [ -f .python-version ]; then
    VERSION=$(cat .python-version)
fi

# 2. 找到真实的 pip 路径
REAL_PIP="~/.pyenv/versions/${VERSION}/bin/pip"

# 3. 执行真实的命令
exec "$REAL_PIP" "$@"

如何查看真实的 pip 路径

虽然 which pip 显示 shim，但您可以通过以下方式找到真实的 pip：

1. 使用 pyenv 命令：

   $ pyenv which pip
   /home/user/.pyenv/versions/3.9.0/envs/myenv/bin/pip

2. 使用 pip 自身：

   $ pip -V
   pip 21.0.1 from /home/user/.pyenv/versions/myenv/lib/python3.9/site-packages/pip (python 3.9)
   
   $ pip --path

3. 直接查看：

   $ ls -la ~/.pyenv/versions/myenv/bin/pip
   $ readlink -f $(which pip)  # 有些系统可以这样

这种设计的好处

1. 透明切换：无需修改 PATH 即可切换环境
2. 惰性加载：只有在执行命令时才决定使用哪个版本
3. 隔离性：每个项目可以有自己的 Python 版本
4. 性能：shim 很轻量，开销小

验证是否真的在使用虚拟环境的 pip

# 方法1：检查 pip 安装位置
$ pip list | head -5

# 方法2：安装测试包查看路径
$ pip install --target=/tmp/test small-package
$ python -c "import sys; print(sys.executable)"

总结

which pip 显示 shim 路径是完全正常的，这是 pyenv 的设计特点。虽然命令看起来来自 shims 目录，但实际上执行的确实是您虚拟环境中的 pip。shim 只是一个智能的转发器，确保您总是在正确的环境中执行命令。