如何查询 Python 当前安装库版本

前言
Python库是预先编译的代码模块，可用于扩展 Python 的功能和能力。在 Python 中，每个库都有一个特定的版本号，用于标识其功能和错误修复。为了有效地管理和使用 Python 库，了解如何查询其当前安装版本至关重要。

方法
查询 Python 当前安装库版本的常用方法包括：

1. pip show
pip show 命令可用于查看有关已安装库的信息，包括版本号。该命令的语法如下：


pip show <package_name>


例如，要查询 NumPy 的当前版本，请运行：


pip show numpy


2. importlib.metadata
importlib.metadata 模块提供了查询已安装库元数据的函数。要使用此模块，请执行以下步骤：

• 导入 importlib.metadata 模块。
• 使用 version() 函数获取库版本。

“`python
import importlib.metadata

version = importlib.metadata.version(“numpy”)
print(version) # 打印 NumPy 版本号
“`

3. pkg_resources
pkg_resources 模块提供了另一种查询已安装库元数据的方法。要使用此模块，请执行以下步骤：

• 导入 pkg_resources 模块。
• 使用 get_distribution() 函数获取库发行信息。
• 使用 version 属性获取库版本。

“`python
import pkg_resources

distribution = pkgresources.getdistribution(“numpy”)
version = distribution.version
print(version) # 打印 NumPy 版本号
“`

4. sys.modules
sys.modules 字典包含已加载模块的信息，包括它们的版本号。要使用此方法，请执行以下步骤：

• 导入要查询其版本的库。
• 使用 __version__ 属性获取版本号。

“`python
import numpy

version = numpy.version
print(version) # 打印 NumPy 版本号
“`

5. 模块文档字符串
某些库会在其文档字符串中包含版本号信息。要访问文档字符串，请使用 __doc__ 属性。

“`python
import numpy

print(numpy.doc) # 打印 NumPy 文档字符串，可能包含版本号
“`

选择合适的方法
以上方法的性能和适用性可能因库和 Python 环境而异。以下是一些指导原则：

• pip show 对于大多数场景都很快且方便。
• importlib.metadata 通常是最准确和更新的方法。
• pkg_resources 为访问其他元数据信息（如依赖项）提供了更全面的方法。
• sys.modules 适用于已加载的库，但可能不适用于所有场景。
• 模块文档字符串可能不可靠，应谨慎使用。

示例
以下 Python 代码演示了如何使用上述方法查询 NumPy 的当前版本：

“`python
import sys
import importlib.metadata
import pkg_resources

使用 pip show

versionpip = subprocess.checkoutput([“pip”, “show”, “numpy”]).decode().split(“\n”)[1].split(“: “)[1]

使用 importlib.metadata

version_metadata = importlib.metadata.version(“numpy”)

使用 pkg_resources

distribution = pkgresources.getdistribution(“numpy”)
versionpkgresources = distribution.version

使用 sys.modules

if “numpy” in sys.modules:
versionsysmodules = sys.modules[“numpy”].version

使用模块文档字符串

import numpy
version_docstring = numpy.doc.split(“\n”)[0].split(” “)[-1]

print(“pip show:”, versionpip)
print(“importlib.metadata:”, versionmetadata)
print(“pkgresources:”, versionpkgresources)
print(“sys.modules:”, versionsysmodules if “numpy” in sys.modules else “Not loaded”)
print(“模块文档字符串:”, versiondocstring)
“`

常见问题解答

1. 如何将库更新到最新版本？
您可以使用 pip install --upgrade <package_name> 命令将库更新到最新版本。

2. 如何管理库的依赖关系？
您可以使用 pip install --no-deps 选项安装库而不安装其依赖关系，或者使用 pip install -r requirements.txt 从 requirements.txt 文件中安装所有库及其依赖关系。

3. 如何卸载库？
您可以使用 pip uninstall <package_name> 命令卸载库。

4. 如何检查库是否已安装？
您可以使用 pip list 命令查看已安装的库列表。

5. 如何解决库版本冲突？
如果安装了多个不同版本的同一库，可以使用 pip install --force-reinstall <package_name> 命令强制重新安装库。