由于环境错误而无法安装软件包：[WinError 5] 访问被拒绝

作者

由于环境错误而无法安装软件包：[WinError 5]访问被拒绝

Could not install packages due to an EnvironmentError: [WinError 5] Access is denied

当我们没有安装软件包所需的权限时，会出现错误“由于环境错误而无法安装软件包：[WinError 5]
访问被拒绝”。

要解决该错误，请运行带有选项的命令--user，例如
pip install tensorflow-gpu --user。

壳
ERROR: Could not install packages due to an EnvironmentError: [WinError 5] Access is denied:
'C:\\Users\\bobbyhadz\\AppData\\Roaming\\Python\\Python310\\site-packages\\Python\\Python310\\site-packages'
Consider using the `--user` option or check the permissions.

--user使用选项安装包

解决该错误的一种方法是运行pip install带有--user
选项的命令。

壳
pip install <package-name> --user
pip3 install <package-name> --user

python -m pip install <package-name> --user
python3 -m pip install <package-name> --user

确保将<package-name>占位符替换为包的实际名称，例如pip install tensorflow-gpu --user。

壳
# 👇️ install correct pacakge with --user option
pip install tensorflow-gpu --user
pip3 install tensorflow-gpu --user

python -m pip install tensorflow-gpu --user
python3 -m pip install tensorflow-gpu --user

# 👇️ on Windows
py -m pip install tensorflow-gpu --user

该--user选项将包安装在用户的主目录中。

该命令基本上安装特定用户范围内的软件包，而不是整个系统。这有助于解决权限问题。

但是，--user如果您有活动的虚拟环境，该选项将不起作用。

pip在安装软件包之前升级您的版本

另一件经常解决该错误的方法是pip在安装特定软件包之前升级您的版本。

壳
python -m pip install --user --upgrade pip
python -m pip install tensorflow-gpu

python3 -m pip install --user --upgrade pip
python3 -m pip install tensorflow-gpu

# 👇️ on Windows
py -m pip install --user --upgrade pip
py -m pip install tensorflow-gpu

确保后台没有运行任何Python脚本

确保在运行安装命令之前停止所有 Python 应用程序。

例如，如果您在后台tensorflow运行应用程序时尝试升级软件包，则会引发错误。tensorflow

您必须停止脚本并重新运行安装命令。

如果这没有帮助，请以管理员身份运行 CMD 并安装该软件包。

以管理员身份运行CMD

以管理员身份运行 CMD：

  1. 单击搜索栏并键入“cmd”。
  2. 右键单击“命令提示符”。
  3. 单击“以管理员身份运行”。

windows以管理员身份运行cmd

  1. 以管理员身份打开 shell 后，重新运行该pip install命令。
壳
pip install <package-name>
pip3 install <package-name>

python -m pip install <package-name>
python3 -m pip install <package-name>
如果您使用 PyCharm，请关闭 IDE，右键单击它并以管理员身份打开 PyCharm，然后运行命令pip install。

如果以管理员身份打开 CMD 没有帮助，请尝试以管理员身份打开 PowerShell 并运行该命令。

以管理员身份运行 PowerShell：

  1. 单击搜索栏并键入“PowerShell”。
  2. 右键单击“Windows PowerShell”。
  3. 单击“以管理员身份运行”。

windows 以管理员身份运行 powershell

导致错误的另一个常见原因是运行命令时在后台运行其他 Python 脚本pip install。

当文件被另一个进程锁定时，Windows 会抛出[WinError 5]访问被拒绝。

如果错误仍然存​​在，请更改用户的访问权限。

更改用户的访问权限

该错误通常是由于用户无权修改应安装包的目录而引起的。

要解决该错误，请允许用户完全访问 Python 目录。

要更改用户的访问权限：

  1. 打开安装 Python 的文件夹，例如
    C:\Program Files (x86)\Python310.

您可以使用以下 2 个命令之一找到 Python 的安装位置。

壳
where python

python -c "import os, sys; print(os.path.dirname(sys.executable))"
  1. 打开安装 Python 的目录后，右键单击“Python”或“Python310”文件夹，然后单击“属性”。

右击属性

  1. 转到“安全”选项卡，然后单击“编辑”按钮。

单击安全选项卡并编辑

  1. 允许对您的用户或整个“用户”组进行“完全控制”。

允许用户完全控制

  1. 点击“应用”。
  2. 再次运行pip install <package-name>命令。

向用户授予“完全访问”权限后，您应该能够
pip install打包而不会出现任何错误。

如果您有一个活动的虚拟环境，您的 Python 位置将被限制在特定的虚拟环境中。

换句话说，您必须为位于项目中的 Python 文件夹的用户编辑权限。

您可以where python在虚拟环境处于活动状态时运行该命令来查找该目录。

升级你的版本pip和setuptools

如果这未能解决错误，请尝试升级您的pip.

壳
# 👇️ if you have pip already installed
pip install --upgrade pip

# 👇️ if your pip is aliased as pip3 (Python 3)
pip3 install --upgrade pip

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install --upgrade pip

# 👇️ if you don't have pip in your PATH environment variable
python3 -m pip install --upgrade pip

# 👇️ if you have easy_install
easy_install --upgrade pip



如果您收到错误“ModuleNotFoundError：Python 中没有名为 ‘pip’ 的模块”，请查看我的另一篇文章：

如果代码示例中的命令不适合您，请单击“Install pip in Python”链接。

升级 pip 后，
还要升级setuptools 。

壳
pip install --upgrade setuptools
pip3 install --upgrade setuptools

python -m pip install --upgrade setuptools
python3 -m pip install --upgrade setuptools

通常可以通过升级pip版本并重新运行
pip install命令来解决。

创建虚拟环境

如果错误仍然存​​在，请尝试创建虚拟环境。

  1. 创建虚拟环境。
  2. 激活虚拟环境。
  3. pip install在虚拟环境处于活动状态时运行命令。
壳
# 👇️ use correct version of Python when creating VENV
python3 -m venv venv

# 👇️ activate on Unix or MacOS
source venv/bin/activate

# 👇️ activate on Windows (cmd.exe)
venv\Scripts\activate.bat

# 👇️ activate on Windows (PowerShell)
venv\Scripts\Activate.ps1

# 👇️ install the specific package in the virtual environment
pip install numpy

确保根据您的操作系统和 shell 使用正确的命令来激活虚拟环境。

您的虚拟环境将使用用于创建它的 Python 版本。

确保不要以 root 身份创建虚拟环境，例如，sudo
因为这样您就只允许 root 用户安装软件包。

如果您使用创建虚拟环境sudo，请尝试更改其权限或在不使用 的情况下重新创建它sudo。

壳
sudo chmod -R 777 venv

上面的命令假设您的虚拟环境位于名为 的文件夹中
venv。

777意味着授予所有用户对该目录内容的完全访问权限。

将“include-system-site-packages”设置为“true”

如果您使用虚拟环境，另一件事可能会有所帮助是：

  1. 打开你的venv文件夹。
  2. 单击该pyvenv.cfg文件。
  3. 将include-system-site-packages属性设置为true。
  4. 保存文件。
  5. 重新运行该pip install命令。

包括系统站点包

重启你的电脑

如果没有其他帮助，请尝试重新启动您的 PC 并重新运行安装命令。

这可能会有所帮助，因为您尝试安装/升级的软件包可能被另一个进程锁定。

关闭进程可能使您能够运行安装命令。

结论

解决“由于环境错误而无法安装软件包：
[WinError 5]访问被拒绝”错误：

  1. 运行pip install带有--user选项的命令。
  2. 安装软件包之前以管理员身份运行 CMD。
  3. 授予用户对 Python 目录的完全访问权限。