由于环境错误而无法安装软件包：[Errno 13] 权限被拒绝

由于环境错误而无法安装软件包：[Errno 13]权限被拒绝

当我们尝试在没有必要权限的文件夹中安装软件包时，会出现错误“由于环境错误而无法安装软件包：[Errno 13]权限被拒绝”。

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

壳

复制了！
Could not install packages due to an EnvironmentError: [Errno 13] Permission denied: '/usr/lib/python2.7/dist-packages'
Consider using the --user option or check the permissions.

使用`--user`标志来解决错误

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

壳

复制了！
pip install <package-name> --user

# 👇️ for Python 3 user pip3
pip3 install <package-name> --user

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

# 👇️ py alias for Windows
py -m pip install <package-name> --user

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

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

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

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

使用提升的权限运行安装命令

解决该错误的另一种方法是通过在命令前面加上sudo.

壳

复制了！
sudo pip install <package-name> --user
sudo pip3 install <package-name> --user

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

创建虚拟环境

或者，您可以创建虚拟环境。

创建虚拟环境。
激活虚拟环境。
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 身份创建虚拟环境，例如，因为这样您就只允许 root 用户安装软件包。 sudo

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

壳

复制了！
sudo chmod -R 777 venv

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

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

如果这不起作用，请尝试升级您的pip版本。

升级你的pip版本

以下是在所有操作系统上升级 pip的命令。

哪个命令有效取决于您的操作系统和 Python 版本。

壳

复制了！
# 👇️ 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

# 👇️ if you get a permissions error
sudo easy_install --upgrade pip

# 👇️ if you get a permissions error when upgrading pip
pip install --upgrade pip --user

# 👇️ upgrade pip scoped to the current user (if you get permissions error)
python -m pip install --user --upgrade pip
python3 -m pip install --user --upgrade pip

# 👇️ Installing directly from get-pip.py (MacOS and Linux)
curl https://bootstrap.pypa.io/get-pip.py | python

# 👇️ if you get permissions issues
curl https://bootstrap.pypa.io/get-pip.py | sudo python

# 👇️ alternative for Ubuntu/Debian
sudo apt-get update && apt-get upgrade python-pip

# 👇️ alternative for Red Hat / CentOS / Fedora
sudo yum install epel-release
sudo yum install python-pip
sudo yum update python-pip

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

在 Python 中安装 pip

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

升级 pip 后，
还要升级setuptools 。

壳

复制了！
pip install --upgrade setuptools

pip3 install --upgrade setuptools

python3 -m pip install --upgrade setuptools

pip尝试安装并升级软件包setuptools。

壳

复制了！
pip install <package-name>

# 👇️ for Python 3 user pip3
pip3 install <package-name>

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

如果这没有帮助，请尝试以管理员身份运行 CMD。

以管理员身份运行CMD

以管理员身份运行 CMD：

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

windows以管理员身份运行cmd

以管理员身份打开 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：

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

windows 以管理员身份运行 powershell

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

当文件被另一个进程锁定时，Windows 会抛出“EnvironmentError: [Errno 13] Permission denied”。

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

更改用户的访问权限

错误“由于环境错误而无法安装软件包：[Errno 13]
权限被拒绝”通常是由于用户无权修改应安装软件包的目录而导致的。

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

要更改用户的访问权限：

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

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

壳

复制了！
where python

python -c "import os, sys; print(os.path.dirname(sys.executable))"

打开安装 Python 的目录后，右键单击“Python”或“Python310”文件夹，然后单击“属性”。

右击属性

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

单击安全选项卡并编辑

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

允许用户完全控制

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

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

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

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

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

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

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

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

包括系统站点包

结论

解决“由于环境错误而无法安装软件包：[Errno 13]权限被拒绝”错误：

运行pip install带有--user选项的命令。
创建一个虚拟环境并在其中安装软件包。
授予用户对 Python 目录的完全访问权限。

由于环境错误而无法安装软件包：HTTPSConnectionPool

当我们尝试在没有必要权限的情况下安装软件包时，会出现错误“由于环境错误而无法安装软件包：HTTPSConnectionPool”。

要解决该错误，请添加受信任的主机或使用该选项运行pip install命令--user。

壳

复制了！
Could not install packages due to an EnvironmentError: HTTPSConnectionPool(host='files.pythonhosted.org', port=443): Max retries exceeded with url: (Caused by ProtocolError('Connection aborted.', ConnectionResetError(10054, 'An existing connection was forcibly closed by the remote host', None, 10054, None)))

导致错误的最常见原因是pip install从代理后面运行命令。

如果您的公司网络受到防火墙保护，这种情况经常会发生。

解决该错误的一种方法是添加受信任的主机。

壳

复制了！
pip install --trusted-host=pypi.python.org --trusted-host=pypi.org --trusted-host=files.pythonhosted.org <package-name>

# 👇️ pip3 (for Python 3)
pip3 install --trusted-host=pypi.python.org --trusted-host=pypi.org --trusted-host=files.pythonhosted.org <package-name>

python -m pip install --trusted-host=pypi.python.org --trusted-host=pypi.org --trusted-host=files.pythonhosted.org <package-name>

# 👇️ for Python3
python3 -m pip install --trusted-host=pypi.python.org --trusted-host=pypi.org --trusted-host=files.pythonhosted.org <package-name>

# 👇️ py alias (Windows)
py -m pip install --trusted-host=pypi.python.org --trusted-host=pypi.org --trusted-host=files.pythonhosted.org <package-name>

如果出现权限错误，请尝试在命令前面加上sudo.

壳

复制了！
sudo pip install --trusted-host=pypi.python.org --trusted-host=pypi.org --trusted-host=files.pythonhosted.org <package-name>

# 👇️ pip3 (for Python 3)
sudo pip3 install --trusted-host=pypi.python.org --trusted-host=pypi.org --trusted-host=files.pythonhosted.org <package-name>

请注意，该命令以结尾<package-name>。确保将占位符替换为您尝试安装的包的名称，例如numpy
或tensorflow。

您还可以使用命令在pip.conf 或 pip.ini文件中设置受信任的主机

，这样您就不必--trusted-host在每次需要安装包时都添加该选项。

壳

复制了！
pip config set global.trusted-host "pypi.python.org pypi.org files.pythonhosted.org" --trusted-host=pypi.python.org --trusted-host=pypi.org --trusted-host=files.pythonhosted.org

将受信任的主机添加到 pip conf ini

该命令会自动将受信任的主机添加到您的pip.conf orpip.ini文件并打印文件的位置。

如果您从代理后面运行命令，请添加该--proxy选项。

壳

复制了！
sudo pip install --trusted-host=pypi.python.org --trusted-host=pypi.org --trusted-host=files.pythonhosted.org --proxy=127.0.0.1:3128 <package-name>

# 👇️ pip3 (for Python 3)
sudo pip3 install --trusted-host=pypi.python.org --trusted-host=pypi.org --trusted-host=files.pythonhosted.org --proxy=127.0.0.1:3128 <package-name>

–proxy选项

用于指定表单中的代理
scheme://[user:passwd@]proxy.server:port。

如果这不起作用，请尝试连接到不在防火墙后面的另一个网络，然后重新运行该pip install命令。

您公司的防火墙可能不允许您访问pypi服务器。

您也可以联系您公司的系统管理员。

您可能会尝试做的其他事情是增加pip install
命令的超时时间。

pip install由于您的 wifi 速度太慢而导致命令超时，也会导致该错误。

壳

复制了！
sudo pip install --default-timeout=180 numpy

sudo pip3 install --default-timeout=180 numpy

确保替换numpy为您尝试安装的软件包的名称。

pip install或者，您可以尝试使用该选项运行该命令--user
。

使用 –user 选项安装软件包

当我们没有安装包的必要权限时，会出现错误“由于环境错误无法安装包：HTTPSConnectionPool”。