Python 代码中怎么获取 ollama 库版本号

在 Python 代码中获取 ollama 库版本号，最稳定且推荐的标准做法是使用 Python 内置的 importlib.metadata.version('ollama')。如果导入了模块，部分环境也可以通过 ollama.__version__ 获取，但使用内置元数据模块能够避免模块未定义版本变量时的报错，适合在工程环境检查、日志上报和依赖排查中使用。

图 1：在 Python 中获取 ollama 客户端版本号的两种主要路径与执行逻辑

1. 场景与区分：客户端 SDK 与服务端版本

假设你正在编写一段自动化脚本，需要使用 Python 驱动本地的大语言模型。在执行推理任务前，你希望在日志中打印依赖库的具体版本，或者判断当前环境是否满足某个新特性所要求的最低版本。此时你所要获取的是 Python 客户端 SDK（即 pip 安装的 ollama 包） 的版本号，而不是 Ollama 服务端二进制程序（如后台运行的 ollama serve）的版本。

对于 Python 包本身，最常见的两种获取机制是读取分发元数据以及读取模块导出的版本属性。下面我们逐一讲解具体实现方法。

2. 方法一：使用 importlib.metadata（推荐标准做法）

从 Python 3.8 开始，标准库提供了 importlib.metadata 模块。它是目前 Python 官方推荐用来读取当前环境中已安装第三方包元数据的标准工具。这种方式的优势在于不需要真正执行 import ollama，哪怕模块内部有较重的初始化逻辑，也不会影响版本读取效率。

from importlib.metadata import version, PackageNotFoundError

try:
    ollama_version = version("ollama")
    print(f"ollama 库版本号: {ollama_version}")
except PackageNotFoundError:
    print("当前 Python 环境中未安装 ollama 库")

代码说明与注意事项：

• version("ollama") 接受的参数是 pip 分发包的名称（即我们在 pip install ollama 中使用的名字）。
• 如果当前虚拟环境或系统环境中没有安装该包，函数会抛出 PackageNotFoundError 异常，建议加上 try-except 结构以便平稳处理未安装的情况。
• 示例输出结果类似于：ollama 库版本号: 0.4.4（具体数值取决于你安装的版本）。

图 2：importlib.metadata 提取包版本元数据的流程细节

3. 方法二：读取模块自带的 __version__ 属性

很多 Python 开发者习惯在导入包之后直接访问 __version__ 属性。官方的 ollama-python 库在多数发布版本中也在顶级包中导出了该属性。

import ollama

# 方式 A：直接读取
try:
    print("ollama 版本:", ollama.__version__)
except AttributeError:
    print("当前安装的 ollama 模块未导出 __version__ 属性")

# 方式 B：使用 getattr 优雅防御
ver = getattr(ollama, "__version__", "未知版本")
print(f"检测到的版本为: {ver}")

特点与潜在风险：

• 该方法必须执行 import ollama。如果环境存在命名冲突（例如当前目录下存在名为 ollama.py 的文件），会导致意外导入本地文件而非第三方库，从而抛出 AttributeError。
• 在不同发版迭代中，个别精简包构建或定制打包可能未将版本号写入 __init__.py，因此不能假设 __version__ 一定百分之百存在。建议优先配合 getattr() 赋予默认缺省值。

4. 方法三：针对较旧 Python 版本的兼容方案

如果项目仍运行在 Python 3.7 或更早的旧环境，或者团队历史代码习惯依赖 setuptools 工具集，可以使用 pkg_resources：

import pkg_resources

try:
    dist_version = pkg_resources.get_distribution("ollama").version
    print(f"通过 pkg_resources 获取的版本: {dist_version}")
except pkg_resources.DistributionNotFound:
    print("未找到 ollama 安装包")

图 3：不同方式的技术特征与适用场景对比

5. 生产级稳健封装与实战示例

在工程项目中，为了保证不管运行环境如何变动都能安全获得版本号，可以编写一个兼顾两者的回退封装函数：

def get_ollama_version() -> str:
    """获取当前环境中 ollama 库的版本号，失败时返回 'Unknown'"""
    # 优先尝试标准库 importlib.metadata
    try:
        from importlib.metadata import version, PackageNotFoundError
        return version("ollama")
    except (ImportError, PackageNotFoundError):
        pass

    # 尝试直接导入模块读取属性
    try:
        import ollama
        if hasattr(ollama, "__version__"):
            return str(ollama.__version__)
    except Exception:
        pass

    return "Unknown"

if __name__ == "__main__":
    current_ver = get_ollama_version()
    print(f"检测完成，ollama Python 客户端版本: {current_ver}")

图 4：在生产环境中应用与处理版本号的标准化闭环