安装软件包的要求

本节介绍在安装其他Python包之前要遵循的步骤。

python --version

>>> python --version
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
NameError: name 'python' is not defined

pip --version

python -m ensurepip --default-pip

python -m pip install --upgrade pip setuptools wheel

python3 -m venv tutorial_env
source tutorial_env/bin/activate

创建虚拟环境

Python“虚拟环境”允许将Python 包安装在特定应用程序的隔离位置，而不是全局安装。

想象一下你有一个需要LibFoo版本1的应用程序，但是另一个应用程序需要版本2.你怎么能使用这两个应用程序？如果您将所有内容都安装到/usr/lib/python3.6/site-packages（或任何您的平台的标准位置），那么很容易导致无意中升级不应升级的应用程序。

或者更一般地说，如果你想安装一个应用程序并保留它，该怎么办？如果应用程序有效，其库中的任何更改或这些库的版本都可能会中断应用程序。

另外，如果您无法将软件包安装到全球站点包目录中，该怎么办？例如，在共享主机上。

在所有这些情况下，虚拟环境都可以帮助您。他们有自己的安装目录，他们不会与其他虚拟环境共享库。

目前，有两种常见的创建Python虚拟环境的工具：

• venv默认在Python 3.3及更高版本中可用，并且在Python 3.4及更高版本中将pip和setuptools安装 到创建的虚拟环境中。
• virtualenv需要单独安装，但支持Python 2.6+和Python 3.3+，默认情况下（无论Python版本如何）， pip，setuptools和 wheel总是安装到创建的虚拟环境中。

基本用法如下所示：

使用virtualenv：

virtualenv <DIR>
source <DIR>/bin/activate

使用venv：

python3 -m venv <DIR>
source <DIR>/bin/activate

有关更多信息，请参阅virtualenv文档或venv文档。

在上述两种情况下，Windows用户都不应该使用 source命令，而应该直接从命令shell 运行激活脚本。在Unix shell下使用源代码确保虚拟环境的变量在当前shell中设置，而不是在子进程中（然后消失，没有有用的效果）。

直接管理多个虚拟环境可能会变得单调乏味，因此 依赖管理教程引入了一个更高级别的工具Pipenv，它可以为您工作的每个项目和应用程序自动管理单独的虚拟环境。

使用pip进行安装

pip是推荐的安装程序。下面，我们将介绍最常见的使用场景。有关更多详细信息，请参阅 pip文档，其中包含完整的参考指南。

从PyPI安装

pip的最常见用法是使用需求说明符从Python包索引进行安装。一般来说，需求说明符由一个项目名称和一个可选的版本说明符组成。 PEP 440包含一个完整说明 当前支持的说明符。以下是一些例子。

要安装最新版本的“SomeProject”：

pip install 'SomeProject'

要安装特定版本：

pip install 'SomeProject==1.4'

要安装大于或等于一个版本并且小于另一个版本：

pip install 'SomeProject>=1,<2'

要安装一个版本 与某个版本 “兼容”： [4]

pip install 'SomeProject~=1.4.2'

在这种情况下，这意味着要安装“> = 1.4.2”版本的任何版本“== 1.4。*”。

源分布与轮子

点可以从 Source Distributions（sdist）或 Wheels安装，但如果两者都存在于PyPI上，pip将更喜欢兼容的车轮。

车轮是一种预建的分发格式，与源代码发布（sdist）相比，可提供更快的安装，特别是当项目包含已编译的扩展时。

如果pip没有找到要安装的轮子，它将在本地构建轮子并将其缓存以供将来安装，而不是将来重新构建源代码分发。

升级包

将已安装的SomeProject从PyPI 升级到最新版本。

pip install --upgrade SomeProject

安装到用户网站

要安装与当前用户隔离的软件包，请使用以下--user标志：

pip install --user SomeProject

有关更多信息，请参阅pip文档中的“ 用户安装”部分。

请注意，该--user标志在虚拟环境中不起作用 - 所有安装命令都会影响虚拟环境。

需求文件

安装需求文件中指定的需求列表。

pip install -r requirements.txt

从VCS安装

以“可编辑”模式从VCS安装项目。有关语法的完整细分，请参阅pip关于VCS支持的部分。

pip install -e git+https://git.repo/some_pkg.git#egg=SomeProject          # from git
pip install -e hg+https://hg.repo/some_pkg#egg=SomeProject                # from mercurial
pip install -e svn+svn://svn.repo/some_pkg/trunk/#egg=SomeProject         # from svn
pip install -e git+https://git.repo/some_pkg.git@feature#egg=SomeProject  # from a branch

从其他索引安装

从备用索引安装

pip install --index-url http://my.package.repo/simple/ SomeProject

除了PyPI之外，还可以在安装过程中搜索其他索引

pip install --extra-index-url http://my.package.repo/simple SomeProject

从本地src树安装

在开发模式下从本地src安装，即以似乎已安装项目的方式安装，但仍可从src树编辑。

pip install -e <path>

您也可以通过src正常安装

pip install <path>

从本地存档安装

安装特定的源档案文件。

pip install ./downloads/SomeProject-1.0.4.tar.gz

从包含档案的本地目录安装（并且不要检查PyPI）

pip install --no-index --find-links=file:///local/dir/ SomeProject
pip install --no-index --find-links=/local/dir/ SomeProject
pip install --no-index --find-links=relative/dir/ SomeProject

从其他来源安装

要从其他数据源（例如Amazon S3存储）进行安装，您可以创建一个助手应用程序，以便在数据源中显示数据 符合 PEP 503的索引格式，并使用该--extra-index-url标志指示pip使用该索引。

./s3helper --port=7777
pip install --extra-index-url http://localhost:7777 SomeProject

安装预发布

除稳定版本外，还可以查找预发行版和开发版。默认情况下，pip只能找到稳定的版本。

pip install --pre SomeProject

安装Setuptools“Extras” 

安装setuptools演员。

$ pip install SomePackage[PDF]
$ pip install SomePackage[PDF]==3.0
$ pip install -e .[PDF]==3.0  # editable project in current directory