pipenv无法识别pyenv-win安装的Python版本问题求助

云原生阿岚

2026-8-8

解决Windows下pyenv-win与pipenv配合使用的版本识别问题

确保pyenv-win的shims路径优先级最高
pyenv-win依赖shims目录的转发机制让系统识别不同Python版本，必须把%USERPROFILE%\.pyenv\pyenv-win\shims放在用户环境变量的Path最顶端，优先级高于系统自带的Python路径。设置完成后必须重启所有终端（cmd、PowerShell都要关闭重开），否则路径变更不会生效。
先激活pyenv目标版本再调用pipenv
先在终端执行pyenv local 3.10.6（仅当前目录生效）或pyenv global 3.10.6（全局生效），然后用python --version确认当前版本是3.10.6，再执行pipenv shell，pipenv会自动使用当前激活的Python版本创建虚拟环境，无需手动指定--python参数。
手动指定pyenv-win安装的Python可执行文件路径
Windows下pyenv-win安装的Python没有bin文件夹（这是Linux/macOS的目录结构），正确的可执行文件路径是%USERPROFILE%\.pyenv\pyenv-win\versions\3.10.6\python.exe。直接用这个路径指定版本：
```
pipenv --python "%USERPROFILE%\.pyenv\pyenv-win\versions\3.10.6\python.exe"
```
注意路径要用双引号包裹，避免路径中存在空格导致识别失败。
清除pipenv版本检测缓存
如果pipenv仍无法识别版本，执行pipenv --clear清除缓存的Python版本列表，之后再重新尝试指定版本或创建环境。
验证pyenv-win的版本安装状态
执行pyenv versions查看已安装的版本列表，确认3.10.6在列表中，且前面带有*标记表示已激活。如果版本不在列表中，重新执行pyenv install 3.10.6确保安装成功。