🔓 第一步:解除文件阻止与调整执
下载压缩包:直接用浏览器访问 pyenv-win 的 GitHub 仓库。点击绿色的
Code按钮,选择Download ZIP。解压并放置文件:
在
C:\Users\你的用户名\目录下,新建一个名为.pyenv的文件夹。将下载的 ZIP 文件解压,把里面的
pyenv-win文件夹(注意不是整个压缩包)移动到刚才创建的.pyenv文件夹内。注意!!如果出现后续问题,建议将github的整个包都移入已创建的.pyenv文件夹而不单单只是pyenv-win这一个文件夹最终目录结构应为:
C:\Users\你的用户名\.pyenv\pyenv-win。
配置环境变量:
在系统搜索栏输入“环境变量”,打开“编辑系统环境变量”。
在“高级”选项卡中点击“环境变量”。
在“用户变量”区域,点击“新建”,变量名输入
PYENV,变量值输入C:\Users\你的用户名\.pyenv\pyenv-win。找到“用户变量”中的
Path,选中并点击“编辑”。添加以下两个新条目(如果不存在的话):C:\Users\你的用户名\.pyenv\pyenv-win\binC:\Users\你的用户名\.pyenv\pyenv-win\shims注意,如果安装pyenv是为了改变python版本的话,最好将这两个path路径上移使其优先级盖过原来的python版本才可生效
验证安装:关闭并重新打开一个 PowerShell 窗口,输入
pyenv --version,如果显示版本号就成功了。
你看到的“安全警告”是因为 PowerShell检测到pyenv.ps1脚本来自互联网。虽然你选择了“运行一次”,但Unblock-File可以永久解除这个警告。
以管理员身份打开 PowerShell。
执行以下命令,解除对
pyenv.ps1脚本的阻止:(powershell 里)
Unblock-File (Join-Path $env:PYENV 'bin\pyenv.ps1')
如果提示
$env:PYENV未定义,请先检查你的环境变量设置。调整 PowerShell 执行策略,以允许运行本地或签名的脚本:
(powershell 里)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
输入
Y确认。即可解决问题(出现其他问题后重新安装了再以管理员身份运行powershell再执行上述这两条命令即可)
📂 第二步:解决“系统找不到指定的文件”错误
这个错误通常意味着PowerShell 无法在PATH环境变量中找到pyenv命令。请按以下步骤仔细检查:
检查环境变量
PYENV:打开“编辑账户的环境变量”。
确保在“用户变量”中存在名为
PYENV的变量,且其值为你的安装路径,例如C:\Users\你的用户名\.pyenv\pyenv-win。
检查
Path变量:在“用户变量”中找到
Path,点击“编辑”。确保其中包含以下两条路径(如果不存在,请手动添加):
%USERPROFILE%\.pyenv\pyenv-win\bin%USERPROFILE%\.pyenv\pyenv-win\shims
验证文件是否存在:
打开文件资源管理器,导航到
C:\Users\你的用户名\.pyenv\pyenv-win\bin。确认
pyenv.ps1文件确实存在于此目录中。
✅ 验证安装
完成上述步骤后,关闭所有 PowerShell 窗口,然后重新打开一个新的(这很重要,以确保环境变量生效)。
输入以下命令进行验证:
powershell
pyenv --version
如果成功,你应该能看到类似pyenv 3.x.x的版本信息。
💡 如果问题依旧
如果仍然报错,可以尝试完全重启电脑,让环境变量彻底更新。
如果以上方法都无效,最彻底的方式是重新进行手动安装:从 GitHub 下载 ZIP 包,解压到C:\Users\你的用户名\.pyenv\pyenv-win目录,并严格按照上述步骤配置环境变量。