Python模块安装方法

安装Python模块

电子邮件 distutils-sig @ python 。组织

作为一个受欢迎的开源开发项目，Python具有活跃的贡献者和用户支持社区，并且根据开放源代码许可条款，其软件可供其他Python开发人员使用。

这使Python用户可以有效地共享和协作，得益于其他人已经针对常见（有时甚至很少见！）问题创建的解决方案，并有可能将自己的解决方案贡献给公共资源库。

本指南涵盖了该过程的安装部分。有关创建和共享自己的Python项目的指南，请参阅 发行指南。

注意

对于公司和其他机构用户，请注意，许多组织在使用和贡献开源软件方面都有自己的政策。在使用Python随附的分发和安装工具时，请考虑此类策略。

关键术语

• pip是首选的安装程序。从Python 3.4开始，它默认包含在Python二进制安装程序中。

• 甲虚拟环境是半隔离的Python环境，允许要安装的软件包使用由特定的应用程序，而不是被安装的系统宽。

• venv是创建虚拟环境的标准工具，自Python 3.3以来已成为Python的一部分。从Python 3.4开始，它默认安装pip到所有创建的虚拟环境中。

• virtualenv是的第三方替代产品（也是其前身） venv。它允许虚拟环境在3.4之前的Python版本上使用，这些虚拟环境根本不提供venv，或者不能自动安装pip到创建的环境中。

• 在Python打包指数是开源的一个公共仓库许可包，以供其他Python用户的使用提供。

• 在Python打包管理局是该组的开发人员和文档的作者负责的标准包装工具维护和发展以及相关的元数据和文件格式标准。他们在GitHub和 Bitbucket上维护各种工具，文档和问题跟踪器。

• distutils是最初于1998年添加到Python标准库中的原始构建和发行系统。虽然distutils逐步淘汰了对它的直接使用，但它仍为当前的打包和发行基础架构奠定了基础，不仅是标准库的一部分，但其名称可以通过其他方式保留（例如，用于协调Python打包标准开发的邮件列表的名称）。

在3.5版本中改变了：采用venv目前推荐用于创建虚拟环境。

也可以看看

Python打包用户指南：创建和使用虚拟环境

基本用法

所有标准包装工具均设计为可从命令行使用。

以下命令将从Python Packaging Index安装模块的最新版本及其依赖项：

python -m pip install SomePackage

注意

对于POSIX用户（包括Mac OS X和Linux用户），本指南中的示例假定使用虚拟环境。

对于Windows用户，本指南中的示例假定在安装Python时选择了调整系统PATH环境变量的选项。

也可以直接在命令行上指定精确或最低版本。当使用比较运营商，如>，<或得到由shell解释其他一些特殊字符，包名和版本应该双引号括起来：

python -m pip install SomePackage==1.0.4    # specific version
python -m pip install "SomePackage>=1.0.4"  # minimum version

通常，如果已经安装了合适的模块，则尝试再次安装它不会起作用。必须明确要求升级现有模块：

python -m pip install --upgrade SomePackage

有关pip其功能的更多信息和资源，请参见《Python打包用户指南》。

虚拟环境的创建是通过venv模块完成的。使用上面显示的命令将软件包安装到活动的虚拟环境中。

也可以看看

Python打包用户指南：安装Python分发包

我如何 …？

这些是一些常见任务的快速解答或链接。

…是否安装pip在Python 3.4之前的Python版本中？

Python才开始pip与Python 3.4 捆绑在一起。对于早期版本， pip需要按照《 Python打包用户指南》中的说明进行“引导”。

也可以看看

Python打包用户指南：安装软件包的要求

…仅为当前用户安装软件包？

传递--user选项将仅为当前用户安装软件包，而不是为系统的所有用户安装软件包。python -m pip install

…安装科学的Python软件包？

许多科学的Python软件包具有复杂的二进制依赖关系，并且目前不容易pip直接使用安装。此时，对于用户而言，通过其他方式安装这些软件包通常 比尝试使用来安装它们更为容易 pip。

也可以看看

Python打包用户指南：安装科学软件包

…是否可以同时安装多个版本的Python？

在Linux，Mac OS X和其他POSIX系统上，结合使用版本化的Python命令和-m开关，以运行以下命令的适当副本 pip：

python2   -m pip install SomePackage  # default Python 2
python2.7 -m pip install SomePackage  # specifically Python 2.7
python3   -m pip install SomePackage  # default Python 3
python3.4 -m pip install SomePackage  # specifically Python 3.4

适当版本的pip命令也可能可用。

在Windows上，将pyPython启动器与-m 开关结合使用：

py -2   -m pip install SomePackage  # default Python 2
py -2.7 -m pip install SomePackage  # specifically Python 2.7
py -3   -m pip install SomePackage  # default Python 3
py -3.4 -m pip install SomePackage  # specifically Python 3.4

常见的安装问题

在Linux上的系统Python中安装

在Linux系统上，Python安装通常会包含在发行版中。安装到此Python安装中需要对系统的root访问权限，并且如果使用意外升级了组件，则可能会干扰系统软件包管理器和系统其他组件的操作pip。

在此类系统上，使用来安装软件包时，通常最好使用虚拟环境或按用户安装pip。

未安装

pip默认情况下可能未安装。一种可能的解决方法是：

python -m ensurepip --default-pip

还有用于安装pip的其他资源。

安装二进制扩展

Python通常严重依赖基于源的分发，最终用户应在安装过程中从源编译扩展模块。

通过引入对二进制wheel格式的支持以及通过Python打包索引发布至少适用于Windows和Mac OS X的车轮的功能，随着时间的流逝，随着用户更经常地能够安装预建组件，该问题有望减少。扩展程序，而不需要自己构建。

某些 尚未安装为预构建文件的科学软件安装解决方案wheel也可能有助于获取其他二进制扩展名，而无需在本地进行构建。

也可以看看

Python打包用户指南：二进制扩展