Windows 下 pyenv 安装 Python 后 python --version 无输出的避坑指南

问题描述

在 Windows 11 系统上，使用 pyenv 安装并切换 Python 版本后，执行 python --version 命令却没有任何输出，一片空白。这不是 Python 没有安装，而是环境配置的坑！

问题根源

通过 where python 命令排查，发现系统中有多个 Python 可执行文件：

text

C:\Users\用户名\AppData\Local\Microsoft\WindowsApps\python.exe
D:\OCR\pyenv-win-master\pyenv-win\shims\python
D:\OCR\pyenv-win-master\pyenv-win\shims\python.bat

罪魁祸首：Windows Store 的 Python 路径优先级高于 pyenv 的路径，导致系统总是先找到 Windows Store 的 Python。

解决方案

方法一：临时调整 PATH（快速测试）

set PATH=D:\OCR\pyenv-win-master\pyenv-win\shims;%PATH%
python --version

方法二：永久修改环境变量（推荐）

1. 按 Win + R，输入 sysdm.cpl

2. 点击"高级"选项卡 → "环境变量"

3. 在 PATH 中将 pyenv 的路径移到最上面：

• D:\OCR\pyenv-win-master\pyenv-win\shims

• D:\OCR\pyenv-win-master\pyenv-win\bin

4. 将 WindowsApps 路径往下移或删除

5. 重启命令行

方法三：禁用 Windows Store Python

# 以管理员身份运行
ren C:\Users\用户名\AppData\Local\Microsoft\WindowsApps\python.exe python.exe.bak

方法四：直接使用完整路径

D:\OCR\pyenv-win-master\pyenv-win\shims\python --version

诊断步骤

当遇到此类问题时，按以下步骤排查：

1. 检查 Python 位置

   cmd

where python
where python.exe

检查 pyenv 状态

cmd

pyenv versions
pyenv version
pyenv which python

检查环境变量

cmd

echo %PATH%
echo %PYTHONHOME%
echo %PYTHONPATH%

预防措施

1. 安装 pyenv 时：建议使用标准路径，避免非常规目录

2. 环境变量设置：确保 pyenv 路径在 PATH 中优先级最高

3. 定期检查：使用 where python 确认当前使用的 Python 来源

经验总结

• Windows 系统的 PATH 优先级是从上到下

• Windows Store 自动安装 Python 会干扰开发环境

• pyenv 的 shims 机制需要正确的 PATH 顺序才能正常工作

遇到类似环境配置问题时，记住：多个同名的可执行文件，系统只认 PATH 中第一个找到的！