Python怎么查看已安装的第三方库列表

木白
木白
发布时间:2026-11-20| 7人浏览过
原创

系统介绍在不同环境与场景下查看Python已安装第三方库列表的完整方法,包含pip list、pip freeze、Python代码内省及IDE查看方式,并附带多环境排查与决策指南。

在 Python 开发与维护过程中,确认当前环境已经安装了哪些第三方库是解决依赖冲突、排查模块缺失以及固化项目运行条件的基础操作。查看已安装库最直接有效的方式是在终端中执行 python -m pip list,如果需要导出供部署使用的依赖清单则使用 pip freeze,而在程序内部动态读取则推荐使用标准库 importlib.metadata。本文将系统讲解这几种方法的具体操作、输出差异、适用边界以及多环境下的避坑要点。

一、终端命令行查看:最直接的两种方式

绝大多数情况下,开发者都是在系统的终端(Windows 的命令提示符或 PowerShell,macOS 与 Linux 的 Terminal)中核对第三方库。Python 官方推荐的包管理工具 pip 提供了两个核心命令:pip list 和 pip freeze。

1. 使用 pip list 查看结构化列表

pip list 命令会扫描当前 Python 环境中的全部安装包,并以双列整齐表格的形式将包名称(Package)和当前版本号(Version)输出在控制台中。

python -m pip list

示例输出如下:

Package            Version
------------------ ---------
certifi            2024.2.2
charset-normalizer 3.3.2
idna               3.6
pip                24.0
requests           2.31.0
setuptools         69.1.1
urllib3            2.2.1

pip list 还提供了多种实用参数以应对不同场景:

  • --outdated:检查当前环境中有哪些库已经发布了更新版本,并列出最新版本号与安装类型。
  • --uptodate:只列出当前已经是最新版本的库。
  • --format=json:将已安装的包列表以 JSON 数组格式输出,非常适合脚本解析或外部集成。
  • --not-required:列出不是作为其他已安装包的依赖项而安装的顶级包,有助于清理无用依赖。

2. 使用 pip freeze 导出精确依赖

与 pip list 的表格排版不同,pip freeze 的输出格式遵循 包名==版本号 的标准规范。该格式主要用于项目的依赖固化与环境迁移。

python -m pip freeze

示例输出如下:

certifi==2024.2.2
charset-normalizer==3.3.2
idna==3.6
requests==2.31.0
urllib3==2.2.1

仔细对比可以发现,pip freeze 默认会过滤掉 pip、setuptools、wheel 等基础构建工具本身,仅保留纯粹的第三方应用依赖。如果需要将当前环境的所有依赖导出为配置文件,只需配合重定向符号即可:

python -m pip freeze > requirements.txt
重要经验:为什么要优先写 python -m pip 而不是直接写 pip?

在许多开发者的计算机中,往往同时存在系统自带 Python、项目虚拟环境 Python 以及全局安装的高版本 Python。直接输入 pip 时,操作系统会按照系统 PATH 环境变量的优先级查找第一个可执行文件,这个 pip 对应的解释器可能根本不是你正在编写代码的 Python。使用 python -m pip list 可以严格保证:你调用的 pip 必然隶属于当前启动的 python 解释器。

Python怎么查看已安装的第三方库列表
图 1:在终端中安全、准确查看已安装第三方库的标准四步流程

二、代码内部查看:在 Python 脚本中获取已安装包信息

在某些开发场景中,我们需要在 Python 代码运行期间动态检查某个插件是否安装、获取当前依赖的版本号,或者向日志输出完整的运行时环境信息。此时无法直接依赖控制台交互,必须通过 Python 代码本身来查询。

1. Python 3.8+ 官方标准库:importlib.metadata

从 Python 3.8 开始,官方标准库引入了 importlib.metadata 模块,成为了获取已安装分发包(Distributions)元数据的标准方法。该模块完全内置,不需要安装任何第三方支持包。

通过 importlib.metadata.distributions() 函数,可以遍历当前 Python 环境中检测到的所有已安装包及其版本:

import importlib.metadata

# 获取当前环境所有已安装的第三方分发包
installed_packages = importlib.metadata.distributions()

for dist in installed_packages:
    name = dist.metadata["Name"]
    version = dist.version
    print(f"{name}: {version}")

如果只想精确查询单个特定包的版本号,可以直接使用 version() 函数:

from importlib.metadata import version, PackageNotFoundError

try:
    pkg_ver = version("requests")
    print(f"requests 已安装,当前版本为: {pkg_ver}")
except PackageNotFoundError:
    print("requests 尚未安装在当前环境中")

2. 传统方案 pkg_resources 的演进与现状

在 Python 3.8 普及之前,社区长期使用 setuptools 提供的 pkg_resources 模块来遍历已安装库:

# 传统旧方案(仅作代码维护参考,新项目请勿使用)
import pkg_resources

for package in pkg_resources.working_set:
    print(f"{package.project_name}=={package.version}")

需要明确指出的是:pkg_resources 在导入时开销较大,且在现代 Python 规范中已被正式弃用(Deprecated)。对于所有 Python 3.8 及以上版本的新项目,均应全面采用 importlib.metadata。

3. 注意区分:已安装的库与已加载的模块

初学者常会混淆 sys.modules 与已安装库的概念。在 Python 中,sys.modules 是一个字典,记录的是当前解释器进程已经 import 到内存中的模块列表。未被代码 import 的第三方库,即使已经安装在硬盘上,也不会出现在 sys.modules 中。因此,查看整个环境的已安装库列表不能使用 sys.modules。

Python怎么查看已安装的第三方库列表
图 2:Python 查看第三方库四大主流方法的维度对比

三、常见开发工具与多环境隔离中的查看方式

在实际项目工程中,现代 Python 开发普遍采用虚拟环境(如 venv、virtualenv、poetry 或 conda)来隔离不同项目的依赖包,避免版本污染。不同的开发工具也提供了便利的可视化与环境专用指令。

1. PyCharm 图形化包管理

在 JetBrains PyCharm 中,可以通过菜单直观查看和管理当前项目解释器的包:

  • 打开菜单:File -> Settings(macOS 为 PyCharm -> Preferences / Settings)。
  • 在左侧导航进入:Project: 项目名 -> Python Interpreter。
  • 右侧主面板会完整列出当前所选解释器中的所有第三方包、已安装版本号(Version)以及最新版本号(Latest Version)。

2. Visual Studio Code 解释器与内置终端

在 VS Code 中,状态栏右下角会清晰展示当前工作区激活的 Python 解释器路径(例如 ('venv': venv) Python 3.11.0)。按下快捷键 Ctrl+Shift+P(macOS 为 Cmd+Shift+P),输入 Python: Select Interpreter 可以随时切换解释器。切换后,在 VS Code 中打开一个新建终端,VS Code 会自动触发该虚拟环境的激活脚本,此时直接输入 pip list 即可准确列出该工作区的库。

3. Anaconda / Miniconda 环境下的查看方式

如果使用 Conda 管理环境,除了 pip 命令之外,还可以使用 Conda 自带的包管理指令:

# 查看当前激活环境中的所有包(同时包含 pip 与 conda 渠道安装的包)
conda list

# 查看指定名称虚拟环境中的包列表(无需先手动激活该环境)
conda list -n my_env

conda list 的特别优势在于其输出的最右侧有一列 Channel,会清晰标注该库是通过 pypi 安装,还是通过 defaults、conda-forge 等 conda 镜像源安装的。

四、高频问题排查:为什么“终端看到了库,代码运行却报错”?

在日常开发问答中,最常见的问题莫过于:“明明在终端里执行 pip list 能看到 requests,为什么在编辑器里一跑代码就抛出 ModuleNotFoundError: No module named 'requests'?”

导致该问题的本质原因绝大多数情况下都是环境割裂:终端执行 pip 的环境,与脚本运行时 Python 解释器的环境并不是同一个。排查与彻底解决该问题需遵循标准路径。

Python怎么查看已安装的第三方库列表
图 3:“终端已安装但代码无法导入”问题的根因排查与解决逻辑
排查口诀:两行代码打印真实解释器

当你怀疑环境不一致时,在代码文件最开头加入两行代码并运行:

import sys
print("当前运行代码的解释器路径为:", sys.executable)

随后在终端中执行 python -c "import sys; print(sys.executable)"。比对两处输出的绝对路径是否字字一致。只要路径有任何微小差异,就说明你正在与两个完全独立的 Python 环境打交道。

五、全景决策与速查总结

掌握 Python 查看第三方库的方法不仅是为了列出名字,更关键在于根据开发流程中的不同节点选择最高效、最可靠的方式。以下是各场景下的快速决策参考:

目标场景 首选指令 / 代码 输出特征 注意事项
日常命令行速查 python -m pip list 整齐表格展示包名与版本 加 python -m 确保与当前解释器绑定
项目依赖锁定与交付 python -m pip freeze > requirements.txt name==version 格式 自动过滤 pip 与 setuptools 构建包
代码内自动化动态检测 importlib.metadata.distributions() Python 可迭代对象与元数据 Python 3.8+ 原生标准库,替代废弃的 pkg_resources
检查过时包与准备升级 python -m pip list --outdated 展示当前版本与最新可用版本 需要能够访问 PyPI 镜像源网络
IDE 图形界面沉浸开发 设置中的 Python Interpreter 面板 可视化交互列表、搜索与点击管理 检查状态栏选定的解释器与工作区虚拟环境一致性
Python怎么查看已安装的第三方库列表
图 4:Python 查看第三方库全景决策与速查总结指南

通过遵循上述原则,开发者无论在单机调试、多人协作还是服务器自动化部署中,都能快速、准确地掌握当前 Python 环境的依赖全貌,从源头上杜绝因环境错位或依赖缺失导致的运行故障。

相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。