https://docs.python.org/zh-cn/3/tutorial/venv.html#
https://packaging.python.org/tutorials/installing-packages/
python安装模块(包)的方式:
pip
是首选的安装程序。从Python 3.4开始,它默认包含在Python二进制安装程序中。
virtual environment 是一种半隔离的 Python 环境,允许为特定的应用安装各自的包,而不是安装到整个系统。venv
是创建虚拟环境的标准工具,从 Python 3.3 开始成为 Python 的组成部分。 从 Python 3.4 开始,它会默认安装 pip
到所创建的全部虚拟环境。
virtualenv
是 venv
的第三方替代(及其前身)。 它允许在 Python 3.4 之前的版本中使用虚拟环境,那些版本或是完全不提供 venv
,或是不会自动安装 pip
到所创建的虚拟环境。
pip用来从预构建的二进制存档安装模块,setuptools和wheel能保证从源码存档安装:
python3 -m pip install --upgrade pip setuptools wheel
几个术语:
Python Packaging Index 是一个由 Python 用户向其他用户发布开源许可软件包的公共仓库。
distutils
是最初的构建和分发系统,于 1998 年首次加入 Python 标准库。 虽然直接使用 distutils
的方式已被淘汰,它仍然是当前打包和分发架构的基础,而且它不仅仍然是标准库的一部分,这个名称还以其他方式存在(例如用于协调 Python 打包标准开发流程的邮件列表就以此命名)。
以下命令将从 Python Packaging Index 安装一个模块的最新版本及其依赖项:
python -m pip install SomePackage
在命令行中指定一个准确或最小版本也是可以的。 当使用比较运算符例如 >
, <
或其他某些可以被终端所解析的特殊字符时,包名称与版本号应当用双引号括起来:
python -m pip install SomePackage==1.0.4 # specific version python -m pip install "SomePackage>=1.0.4" # minimum version
python3 -m pip install "SomeProject>=1,<2" # 安装大于等于1但小于2的版本
python3 -m pip install "SomeProject~=1.4.2" # 安装兼容于1.4.2的版本,这意味着安装任何==1.4.*且>=1.4.2的版本
通常,如果一个匹配的模块已安装,尝试再次安装将不会有任何效果。 要升级现有模块必须显式地发出请求:
python -m pip install --upgrade SomePackage
更多有关 pip
及其功能的信息和资源可以在 Python 软件包用户指南 中找到。
虚拟环境的创建可使用 venv
模块来完成。 向已激活虚拟环境安装软件包可使用上文所介绍的命令。
在 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 中,使用 py
Python 启动器命令配合 -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 版本作为发行版的一部分包含在内。 将软件包安装到这个 Python 版本上需要系统 root 权限,并可能会干扰到系统包管理器和其他系统组件的运作,如果这些组件在使用 pip
时被意外升级的话。
在这样的系统上,通过 pip
安装软件包通常最好是使用虚拟环境或分用户安装。
https://docs.python.org/zh-cn/3/tutorial/venv.html#
你可以使用一个名为 pip 的程序来安装、升级和移除软件包。 默认情况下 pip
将从 Python Package Index <https://pypi.org> 安装软件包。 你可以在你的 web 浏览器中查看 Python Package Index。
pip
有许多子命令: "install", "uninstall", "freeze" 等等。 (请在 安装 Python 模块 指南页查看完整的 pip
文档。)
可以运行 pip install --upgrade
将软件包升级到最新版本:
(tutorial-env) $ python -m pip install --upgrade requests Collecting requests Installing collected packages: requests Found existing installation: requests 2.6.0 Uninstalling requests-2.6.0: Successfully uninstalled requests-2.6.0 Successfully installed requests-2.7.0
pip uninstall
后跟一个或多个包名称将从虚拟环境中删除包。
pip show
将显示有关特定包的信息:
(tutorial-env) $ pip show requests --- Metadata-Version: 2.0 Name: requests Version: 2.7.0 Summary: Python HTTP for Humans. Home-page: http://python-requests.org Author: Kenneth Reitz Author-email: me@kennethreitz.com License: Apache 2.0 Location: /Users/akuchling/envs/tutorial-env/lib/python3.4/site-packages Requires:
pip list
将显示虚拟环境中安装的所有软件包:
(tutorial-env) $ pip list novas (3.1.1.3) numpy (1.9.2) pip (7.0.3) requests (2.7.0) setuptools (16.0)
pip freeze` 将生成一个类似的已安装包列表,但输出使用 pip install
期望的格式。一个常见的约定是将此列表放在 requirements.txt
文件中:
(tutorial-env) $ pip freeze > requirements.txt (tutorial-env) $ cat requirements.txt novas==3.1.1.3 numpy==1.9.2 requests==2.7.0
然后可以将 requirements.txt
提交给版本控制并作为应用程序的一部分提供。然后用户可以使用 install -r
安装所有必需的包:
(tutorial-env) $ python -m pip install -r requirements.txt Collecting novas==3.1.1.3 (from -r requirements.txt (line 1)) ... Collecting numpy==1.9.2 (from -r requirements.txt (line 2)) ... Collecting requests==2.7.0 (from -r requirements.txt (line 3)) ... Installing collected packages: novas, numpy, requests Running setup.py install for novas Successfully installed novas-3.1.1.3 numpy-1.9.2 requests-2.7.0
https://packaging.python.org/tutorials/installing-packages/
pip可以安装发行源码Source Distributions或Wheels,如果两者都出现在PyPI,pip将优先安装兼容的wheel。Wheels是预构建的发行格式,提供比源码发行更快的安装速度,特别当一个项目包含编译的扩展时。如果pip没找到wheel,它将本地构建一个wheel并缓存之,以便未来的安装,而不是在未来重新构建发行源码。
要隔离于当前用户安装包,而不是安装到系统全局的site-packages,使用--user标志:
python3 -m pip install --user SomeProject
注意到--user标志当在虚拟环境中使用时是没有效果的,所有安装命令都将影响虚拟环境。