We use cookies to ensure that we give you the best experience on our website.

使用 pip 和虚拟环境安装 Python 包

Python虚拟环境可以防止Python项目中的包冲突。使用pip在虚拟环境（或每个用户）内保持 Python 系统稳定并使安装、升级和卸载变得简单，如《Python 打包用户指南》中所述：以及官方文档.

步骤一：检查 Python 是否可用。

python --version

步骤2：检查 pip 是否可用。

python -m pip --version

步骤3：创建虚拟环境。

python -m venv .venv

第4步：激活虚拟环境。

# Unix/macOS
source .venv/bin/activate

# Windows
.\.venv\Scripts\activate

第5步：升级 venv 内的 pip、setuptools 和wheel。

python -m pip install --upgrade pip setuptools wheel

第6步：从 PyPI 安装包。

python -m pip install "SomeProject"

第7步：使用标准说明符 (PEP 440) 固定特定版本。

# exact version
python -m pip install "SomeProject==1.4"

# version range
python -m pip install "SomeProject>=1,<2"

# compatible release (e.g., 1.4.* and >=1.4.2)
python -m pip install "SomeProject~=1.4.2"

步骤8：将您的环境记录到需求文件中。

python -m pip freeze > requirements.txt

pip 更喜欢预构建的wheel，以实现更快、更可靠的安装，并且如果只有源存档可用，则会在本地构建一个wheel。您可以使用以下命令覆盖二进制使用--no-binary当需要时。

方法 2 — 安装到用户站点（无需管理员权限）

步骤一：仅为您的用户帐户安装一个软件包。

python -m pip install --user SomeProject

步骤2：将用户脚本目录添加到您的PATH如果未找到命令行脚本。

# Linux/macOS: get base dir, then add "bin" to PATH
python -m site --user-base

# Windows: get user site path, then replace "site-packages" with "Scripts"
py -m site --user-site

注意--user在虚拟环境中没有任何影响——一切都安装到该 venv 中。

方法 3 — 从需求文件安装

步骤一：放置一个requirements.txt在您的项目中创建一个文件，每行一个要求。

步骤2：通过一个命令安装所有固定的依赖项。

python -m pip install -r requirements.txt

方法 4 — 高级点选项

步骤一：从 VCS URL 安装可编辑项目。

python -m pip install -e SomeProject @ git+https://github.com/org/repo.git

步骤2：安装预发布或开发版本。

python -m pip install --pre SomeProject

步骤3：安装包“extras”（可选功能）。

python -m pip install "SomePackage[PDF]"

第4步：从本地存档或目录安装。

# from a local file
python -m pip install ./downloads/SomeProject-1.0.4.tar.gz

# from a local directory (editable)
python -m pip install -e .

第5步：需要时使用私有或备用包索引。

# replace URL with your repository
python -m pip install --index-url https://my.repo/simple SomeProject

请参阅官方文档中有关 VCS 支持和其他选项的 pip 参考.

方法 5 — 修复常见安装问题

步骤一：使用模块调用来避免 PATH 问题。

python -m pip --version

步骤2：如果缺少 Bootstrap pip。

python -m ensurepip --default-pip

步骤3：如果需要，请通过安装get-pip.py请谨慎使用操作系统管理的 Python。

# securely download get-pip.py using a browser or TLS-verifying tool
# then run:
python get-pip.py

# to avoid interfering with system-managed Python on Unix-like OSes:
python get-pip.py --prefix=/usr/local/

第4步：更喜欢python3在 Linux 发行版上并避免sudo对于 pip 命令。

# Linux example: per-user install without sudo
python3 -m pip install --user SomeProject

第5步：通过添加前缀从 Jupyter 运行 shell 命令!并使用当前内核的Python。

import sys
!{sys.executable} --version
!{sys.executable} -m pip install "SomeProject"

上述官方指导（包括避免sudo、使用虚拟环境以及管理用户安装的 PATH）在《Python 打包用户指南》中进行了介绍，网址为以及 Python 的“安装 Python 模块”，网址为。版本说明符遵循 PEP 440，位于，虚拟环境详细信息位于.

通过 pip 加 venv 或按用户安装，您可以保持系统 Python 完整，消除权限问题，并使依赖管理可重现。保存您的要求，您就可以在任何计算机上快速重新创建环境。

Also Read