正文
如何在 PyPI安装python的软件包？
提示：扫一扫查出行【扫一扫了解最新限行尾号】
复制提示
安装软件包
本节介绍如何安装Python的基本知识。包裹.
需要注意的是，这个上下文中的“包”一词被用作分布(即要安装的一组软件)，而不是指包装在Python源代码中导入(即模块的容器)。Python社区中常见的引用分布使用“包”一词。使用“分发”这个术语通常是不可取的，因为它很容易与Linux发行版或另一个更大的软件发行版(如Python本身)混淆。
内容
安装软件包的要求
确保可以从命令行运行Python
确保您可以从命令行运行pip。
确保pip、setuptools和轮子都是最新的。
或者，创建一个虚拟环境。
创建虚拟环境
使用pip安装
从PyPI安装
源分布与车轮
升级包
安装到用户站点
需求文件
从VCS安装
从其他索引安装
从本地src树安装
从本地档案安装
从其他来源安装
安装预放映机
安装Setuptools“Extras”
安装软件包的要求
本节描述安装其他Python包之前应遵循的步骤。
确保可以从命令行运行Python
在进一步研究之前，请确保您有Python，并且您的命令行中提供了预期的版本。您可以通过运行以下命令（win+r打开命令行，然后运行如下命令）来检查这一点：
python --version
你应该得到一些输出，比如Python 3.6.3...如果您没有Python，请从python.org或参考安装Python“Hitchhiker Python指南”一节。
注
如果您是新来的，并且遇到这样的错误：
>>>
>>> python --version
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
NameError: name 'python' is not defined
这是因为本教程中的这个命令和其他建议的命令打算在壳(又称a终端或控制台)。见Python for初学者入门教程有关使用操作系统的shell和与Python交互的介绍。
注
如果您使用的是增强的shell(如IPython或木星笔记本)，则可以运行系统命令，如本教程中的命令，方法是使用!性格：
In [1]: import sys
!{sys.executable} --version
Python 3.6.3
建议写{sys.executable}而不是平淡python为了确保在Python安装中运行与当前正在运行的记事本相匹配的命令(这可能不是与python(命令指)。
注
由于大多数Linux发行版处理Python 3迁移的方式，使用系统Python而不创建虚拟环境的Linux用户应该首先替换python本教程中的python3而pip命令用pip3 --user...做不运行本教程中的任何命令sudo：如果您获得了权限错误，请回到关于创建虚拟环境的部分，设置一个环境，然后继续编写教程。
确保您可以从命令行运行pip。
另外，你需要确保PIP可用。您可以通过运行以下命令来检查这一点：
pip --version
如果您从源代码安装Python，则使用python.org，或通过自制你应该已经有了。如果您在Linux上并使用操作系统包管理器安装，则可能需要单独安装pip，请参见用Linux包管理器安装pip/setuptools/轮子.
如果pip还没有安装，那么首先尝试从标准库引导它：
python -m ensurepip --default-pip
如果这还不能让你跑pip:
安全下载get-pip.py 1
跑
python get-pip.py. 2这将安装或升级pip。此外，它将安装设置工具和车轮如果他们还没安装好的话。警告
如果您使用的是由操作系统或其他包管理器管理的Python安装，请小心。py与这些工具不协调，可能会使您的系统处于不一致的状态。你可以用
python get-pip.py --prefix=/usr/local/安装在/usr/local这是为本地安装的软件设计的。
确保pip、setuptools和轮子都是最新的。
当pip单独安装就足以从预构建的二进制档案中安装，直到最新的副本。setuptools和wheel项目对于确保您也可以从源档案中安装非常有用：
python -m pip install --upgrade pip setuptools wheel
或者，创建一个虚拟环境。
看见下面一节关于细节，但是这里是基本的文夫 3命令用于典型的Linux系统：
python3 -m venv tutorial_env
source tutorial_env/bin/activate
这将在tutorial_env子目录，并配置当前shell以将其用作默认值。python环境。
创建虚拟环境
Python“虚拟环境”允许Python包裹安装在特定应用程序的独立位置，而不是全局安装。如果您希望安全地安装全局命令行工具，请参见安装独立命令行工具.
假设您有一个需要LibFoo版本1的应用程序，而另一个应用程序需要版本2。如果将所有内容安装到/usr/lib/python3.6/site-Package(或平台的标准位置)中，那么很容易在无意中升级不应该升级的应用程序的情况下结束。
或者更广泛地说，如果您想安装一个应用程序而不安装它呢？如果应用程序工作正常，那么其库或这些库的版本中的任何更改都会破坏应用程序。
另外，如果你不能安装包裹进入全局站点-软件包目录？例如，在共享主机上。
在所有这些情况下，虚拟环境都可以帮助您。它们有自己的安装目录，不与其他虚拟环境共享库。
目前，有两种常见的创建Python虚拟环境的工具：
文夫默认情况下在Python3.3及更高版本中可用，并安装PIP和设置工具在Python3.4及更高版本中创建的虚拟环境。
虚拟人需要单独安装，但支持Python2.7+和Python3.3+，并且PIP, 设置工具和车轮默认情况下总是安装在创建的虚拟环境中(不管Python版本如何)。
基本用法如下：
使用文夫:
python3 -m venv <DIR>
source <DIR>/bin/activate
使用虚拟人:
virtualenv <DIR>
source <DIR>/bin/activate
有关更多信息，请参见文夫医生或虚拟人医生。
使用来源在Unixshell下，确保虚拟环境的变量是在当前shell中设置的，而不是在子进程中设置的(子进程随后消失，没有任何有用的效果)。
在上述两种情况下，Windows用户都应该使用来源命令，但是应该运行激活脚本直接来自命令shell，如下所示：
<DIR>\Scripts\activate
直接管理多个虚拟环境可能会变得乏味，因此依赖关系管理教程引入了一个更高级的工具，皮蓬，它会自动管理您工作的每个项目和应用程序的单独虚拟环境。
使用pip安装
PIP是推荐的安装程序。下面，我们将介绍最常见的使用场景。有关更多细节，请参见PIP文档，其中包括一个完整的参考指南.
从PyPI安装
最常见的用法PIP是从Python包索引使用需求说明符...一般来说，需求说明符由一个项目名称和一个可选的项目名称组成。版本说明符. 佩普440包含全规格当前支持的说明符。下面是一些例子。
安装最新版本的“SomeProject”：
pip install "SomeProject"
若要安装特定版本，请执行以下操作：
pip install "SomeProject==1.4"
安装大于或等于一个版本而小于另一个版本：
pip install "SomeProject>=1,<2"
安装的版本“兼容”有一个特定的版本：4
pip install "SomeProject~=1.4.2"
在本例中，这意味着安装“=1.4.*”版本，也就是“>=1.4.2”版本。
源分布与车轮
PIP可以从源分布(Sdist)或车轮，但是如果两者都出现在pypi上，pip会更喜欢兼容的。车轮.
车轮是预建的分布提供更快安装速度的格式源分布(Sdist)，尤其是当项目包含已编译的扩展时。
如果PIP如果找不到要安装的车轮，它将在本地构建一个车轮并将其缓存以供将来安装，而不是在将来重新构建源分布。
升级包
升级已安装的SomeProject来自PyPI的最新报道。
pip install --upgrade SomeProject
安装到用户站点
安装包裹与当前用户隔离的，请使用--user国旗：
pip install --user SomeProject
有关更多信息，请参见用户安装从PIP文档中分离出来。
注意，--user当在虚拟环境中时，标志没有效果-所有安装命令都会影响虚拟环境。
如果SomeProject定义任何命令行脚本或控制台入口点，--user将使它们安装在用户群的二进制目录，该目录可能已经存在，也可能没有出现在shell的PATH...(从版本10开始，pip在将脚本安装到外部目录时显示警告。PATH)如果安装后shell中的脚本不可用，则需要将该目录添加到PATH:
在linux和macos上，您可以通过运行
python -m site --user-base加上bin一直到最后。例如，这通常会打印~/.local(与~扩展到指向主目录的绝对路径)，因此需要添加~/.local/bin敬你的PATH...你可以把你的PATH永久地修改~/.剖面.在Windows上，您可以通过运行
py -m site --user-site替换site-packages带着Scripts...例如，这可能会返回C:\Users\Username\AppData\Roaming\Python36\site-packages所以你需要把你的PATH包括C:\Users\Username\AppData\Roaming\Python36\Scripts...您可以设置您的用户。PATH永久保存在控制面板...您可能需要注销PATH更改生效。
需求文件
中指定的要求列表。需求文件.
pip install -r requirements.txt
从VCS安装
在“可编辑”模式下从VCS安装一个项目。有关语法的完整细分，请参见pip关于风投支持.
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
从其他来源安装
要从其他数据源(例如AmazonS 3存储)安装，可以创建一个在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
