☰
用github仓库里的的https://github.com/pyenv-win/pyenv-win下载pyenv包可能的报错问题解决
2026/9/27 21:51:37 网站建设 项目流程

🔓 第一步:解除文件阻止与调整执

  1. 下载压缩包:直接用浏览器访问 pyenv-win 的 GitHub 仓库。点击绿色的Code按钮,选择Download ZIP。

  2. 解压并放置文件:

    • 在C:\Users\你的用户名\目录下,新建一个名为.pyenv的文件夹。

    • 将下载的 ZIP 文件解压,把里面的pyenv-win文件夹(注意不是整个压缩包)移动到刚才创建的.pyenv文件夹内。注意!!如果出现后续问题,建议将github的整个包都移入已创建的.pyenv文件夹而不单单只是pyenv-win这一个文件夹

    • 最终目录结构应为:C:\Users\你的用户名\.pyenv\pyenv-win。

  3. 配置环境变量:

    • 在系统搜索栏输入“环境变量”,打开“编辑系统环境变量”。

    • 在“高级”选项卡中点击“环境变量”。

    • 在“用户变量”区域,点击“新建”,变量名输入PYENV,变量值输入C:\Users\你的用户名\.pyenv\pyenv-win。

    • 找到“用户变量”中的Path,选中并点击“编辑”。添加以下两个新条目(如果不存在的话):

      • C:\Users\你的用户名\.pyenv\pyenv-win\bin

      • C:\Users\你的用户名\.pyenv\pyenv-win\shims

      • 注意,如果安装pyenv是为了改变python版本的话,最好将这两个path路径上移使其优先级盖过原来的python版本才可生效

  4. 验证安装:关闭并重新打开一个 PowerShell 窗口,输入pyenv --version,如果显示版本号就成功了。

你看到的“安全警告”是因为 PowerShell检测到pyenv.ps1脚本来自互联网。虽然你选择了“运行一次”,但Unblock-File可以永久解除这个警告。

  1. 以管理员身份打开 PowerShell。

  2. 执行以下命令,解除对pyenv.ps1脚本的阻止:

    (powershell 里)

    Unblock-File (Join-Path $env:PYENV 'bin\pyenv.ps1')

    如果提示$env:PYENV未定义,请先检查你的环境变量设置。

  3. 调整 PowerShell 执行策略,以允许运行本地或签名的脚本:

    (powershell 里)

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    输入Y确认。即可解决问题(出现其他问题后重新安装了再以管理员身份运行powershell再执行上述这两条命令即可)

📂 第二步:解决“系统找不到指定的文件”错误

这个错误通常意味着PowerShell 无法在PATH环境变量中找到pyenv命令。请按以下步骤仔细检查:

  1. 检查环境变量PYENV:

    • 打开“编辑账户的环境变量”。

    • 确保在“用户变量”中存在名为PYENV的变量,且其值为你的安装路径,例如C:\Users\你的用户名\.pyenv\pyenv-win。

  2. 检查Path变量:

    • 在“用户变量”中找到Path,点击“编辑”。

    • 确保其中包含以下两条路径(如果不存在,请手动添加):

      • %USERPROFILE%\.pyenv\pyenv-win\bin

      • %USERPROFILE%\.pyenv\pyenv-win\shims

  3. 验证文件是否存在:

    • 打开文件资源管理器,导航到C:\Users\你的用户名\.pyenv\pyenv-win\bin。

    • 确认pyenv.ps1文件确实存在于此目录中。

✅ 验证安装

完成上述步骤后,关闭所有 PowerShell 窗口,然后重新打开一个新的(这很重要,以确保环境变量生效)。

输入以下命令进行验证:

powershell

pyenv --version

如果成功,你应该能看到类似pyenv 3.x.x的版本信息。

💡 如果问题依旧

如果仍然报错,可以尝试完全重启电脑,让环境变量彻底更新。

如果以上方法都无效,最彻底的方式是重新进行手动安装:从 GitHub 下载 ZIP 包,解压到C:\Users\你的用户名\.pyenv\pyenv-win目录,并严格按照上述步骤配置环境变量。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询