pyenv虚拟环境安装包后，二进制文件仍指向~/.local/bin问题求助

问题场景 #

创建并激活pyenv虚拟环境后，安装的工具无法通过直接命令调用，路径指向全局~/.local/bin而非虚拟环境内部。

重现步骤 #

1. 创建并激活虚拟环境：

$ pyenv virtualenv 3.8.10 da38
$ pyenv activate da38
(da38) $

2. 在虚拟环境内用pip3.8安装mypy：

(da38) $ pip3.8 install mypy
Collecting mypy
  Using cached mypy-0.971-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl (17.3 MB)
Requirement already satisfied: mypy-extensions>=0.4.3 in /home/fox/.pyenv/versions/3.8.10/envs/da38/lib/python3.8/site-packages (from mypy) (0.4.3)
Requirement already satisfied: typing-extensions>=3.10 in /home/fox/.pyenv/versions/3.8.10/envs/da38/lib/python3.8/site-packages (from mypy) (4.3.0)
Requirement already satisfied: tomli>=1.1.0 in /home/fox/.pyenv/versions/3.8.10/envs/da38/lib/python3.8/site-packages (from mypy) (2.0.1)
Installing collected packages: mypy
Successfully installed mypy-0.971
(da38) $ 

异常表现 #

• 直接调用mypy报错，路径指向全局目录：

(da38) $ mypy
Traceback (most recent call last):
  File "/home/fox/.local/bin/mypy", line 5, in <module>
    from mypy.__main__ import console_entry
ModuleNotFoundError: No module named 'mypy'
(da38) $ which mypy
/home/fox/.local/bin/mypy
(da38) $

• pip/pip3指向全局~/.local/bin，但pip3.8和pyenv which查询的路径正常：

(da38) $ which pip
/home/fox/.local/bin/pip
(da38) $ which pip3
/home/fox/.local/bin/pip3
(da38) $ which pip3.8
/home/fox/.pyenv/shims/pip3.8
(da38) $ 

(da38) $ pyenv which pip
/home/fox/.pyenv/versions/da38/bin/pip
(da38) $ pyenv which pip3
/home/fox/.pyenv/versions/da38/bin/pip3
(da38) $ pyenv which pip3.8
/home/fox/.pyenv/versions/da38/bin/pip3.8
(da38) $

• 使用虚拟环境内mypy的完整路径可正常运行，且虚拟环境状态、包安装均正常：

(da38) $ /home/fox/.pyenv/versions/3.8.10/envs/da38/bin/mypy daudit/sap.py 
Success: no issues found in 1 source file
(da38) $ 

(da38) $ pyenv virtualenvs
  3.8.10/envs/da38 (created from /home/fox/.pyenv/versions/3.8.10)
* da38 (created from /home/fox/.pyenv/versions/3.8.10)
(da38) $

(da38) $ pip3.8 show mypy
Name: mypy
Version: 0.971
Summary: Optional static typing for Python
...
Location: /home/fox/.pyenv/versions/3.8.10/envs/da38/lib/python3.8/site-packages
Requires: mypy-extensions, tomli, typing-extensions
(da38) $ 

解决方法 #

1. 调整PATH优先级，确保pyenv shims在前 #

检查当前PATH顺序：

echo $PATH

如果~/.local/bin在/home/fox/.pyenv/shims之前，修改shell配置文件（如~/.bashrc或~/.zshrc），将pyenv的初始化语句放在添加~/.local/bin到PATH的语句之后，或直接添加：

export PATH="/home/fox/.pyenv/shims:$PATH"

修改后重载配置：

source ~/.bashrc  # 对应你的shell配置文件

2. 重新安装虚拟环境内的pip #

用虚拟环境的Python重新安装并升级pip：

(da38) $ python3.8 -m ensurepip --upgrade

之后pip/pip3会指向虚拟环境内部的版本。

3. 执行pyenv rehash更新shims #

激活虚拟环境后运行：

(da38) $ pyenv rehash

让pyenv重新生成命令映射，确保工具指向虚拟环境内的可执行文件。

4. 清理全局目录冲突的可执行文件 #

若之前用pip install --user安装过pip、mypy等工具，导致全局路径优先级过高，可删除冲突文件：

rm ~/.local/bin/pip ~/.local/bin/pip3 ~/.local/bin/mypy

重新激活虚拟环境后，即可正常调用虚拟环境内的工具。

内容的提问来源于stack exchange，提问作者user3313834