pip list 命令用于列出所有已经安装的包，包括可编辑的包

语法

pip list 命令的语法格式如下

pip list [options]

列表的排序顺序使用的是不区分大小写的 ASCII 顺序

选项

• -o, --outdated

  列出已经过时的包

• -u, --uptodate

  列出已经更新到最新版本的包

• -e, --editable

  列出所有可编辑的项目

• -l, --local

  只列出在虚拟环境中安装的包，也就是不列出全局安装的包

  一般只在虚拟环境中使用 + --user

  只列出用户级别的已安装的包

• --pre

  包含预发布的版本和开发版本，默认情况下， pip 只会查找稳定版本versions.

• --format <list_format>

  设置输出格式，可选的值有 columns ( 默认 ), freeze, json 或 legacy

• --not-required

  列出那些不是已安装包的依赖项的包

• --exclude-editable

  从输出中排除可编辑的包

• --include-editable

  输出结果中包含可编辑的包

• -i, --index-url <url>

  Python 包索引的基础 URL 地址，默认为 https://pypi.org/simple

  该选项的值应该指向符合 PEP503 ( 简单存储库 API ) 的存储库或以相同格式布局的本地目录

• --extra-index-url <url>

  除了 --index-url 之外的附加的 Python 包索引 URL，规则和 --index-url 一样

• --no-index

  忽略包索引，只查找 --find-links 指定的网址

• -f, --find-links <url>

  如果提供的 URL 或路径链接到一个 html 文件，则会解析该 html 文件以获取归档

  如果是本地目录，或 file://url 指向的是一个目录，那么就在该目录中查找归档

• --process-dependency-links

  启用依赖关系链接的处理

范例

1. 列出所有已安装的包

   $ pip list
   Package      Version  
   ------------ ---------
   certifi      2018.4.16
   chardet      3.0.4    
   click        6.7      
   Flask        1.0.2    
   idna         2.7      
   itsdangerous 0.24     
   Jinja2       2.10     
   MarkupSafe   1.0      
   pip          10.0.1   
   requests     2.19.1   
   setuptools   39.0.1   
   urllib3      1.23     
   Werkzeug     0.14.1
   

2. 列出过时的包 ( 排除可编辑的 ) 并显示当前可用的最新版本

   $ pip list --outdated
   docutils (Current: 0.10 Latest: 0.11)
   Sphinx (Current: 1.2.1 Latest: 1.2.2)
   

3. 列出所有已安装的包，并使用 column 格式输出结果

   $ pip list --format columns
   Package      Version  
   ------------ ---------
   certifi      2018.4.16
   chardet      3.0.4    
   click        6.7      
   Flask        1.0.2    
   idna         2.7      
   itsdangerous 0.24     
   Jinja2       2.10     
   MarkupSafe   1.0      
   pip          10.0.1   
   requests     2.19.1   
   setuptools   39.0.1   
   urllib3      1.23     
   Werkzeug     0.14.1
   

4. 列出所有已过时的包，并使用 column 格式输出结果

   $ pip list -o --format columns
   Package    Version Latest Type
   ---------- ------- ------ -----
   retry      0.8.1   0.9.1  wheel
   setuptools 20.6.7  21.0.0 wheel
   

5. 列出所有不被其它包依赖的包，还可以添加其它选项

   $ pip list --outdated --not-required
   docutils (Current: 0.10 Latest: 0.11)
   

6. 使用 legacy 格式输出结果

   $ pip list --format=legacy
   DEPRECATION: The legacy format has been deprecated and will be removed in the future.
   certifi (2018.4.16)
   chardet (3.0.4)
   click (6.7)
   Flask (1.0.2)
   idna (2.7)
   itsdangerous (0.24)
   Jinja2 (2.10)
   MarkupSafe (1.0)
   pip (10.0.1)
   requests (2.19.1)
   setuptools (39.0.1)
   urllib3 (1.23)
   Werkzeug (0.14.1)
   

7. 使用 JSON 格式输出结果

   $ pip list --format=json
   [{"name": "certifi", "version": "2018.4.16"}, {"name": "chardet", "version": "3.0.4"}, {"name": "click", "version": "6.7"}, {"name": "Flask", "version": "1.0.2"}, {"name": "idna", "version": "2.7"}, {"name": "itsdangerous", "version": "0.24"}, {"name": "Jinja2", "version": "2.10"}, {"name": "MarkupSafe", "version": "1.0"}, {"name": "pip", "version": "10.0.1"}, {"name": "requests", "version": "2.19.1"}, {"name": "setuptools", "version": "39.0.1"}, {"name": "urllib3", "version": "1.23"}, {"name": "Werkzeug", "version": "0.14.1"}]
   

8. 使用 freeze 格式输出结果 formatting

   $ pip list --format=freeze
   certifi==2018.4.16
   chardet==3.0.4
   click==6.7
   Flask==1.0.2
   idna==2.7
   itsdangerous==0.24
   Jinja2==2.10
   MarkupSafe==1.0
   pip==10.0.1
   requests==2.19.1
   setuptools==39.0.1
   urllib3==1.23
   Werkzeug==0.14.1