当前位置：首页 > 文章列表 > 文章 > python教程 > argparse自定义--version显示版本号方法

argparse自定义--version显示版本号方法

2026-02-02 15:45:52 0浏览收藏

从现在开始，我们要努力学习啦！今天我给大家带来《使用 argparse 时，可以通过自定义 --version 参数来自动显示包的版本号。以下是实现方法：方法一：使用 argparse 的 version 参数（适用于 Python 3.4+）import argparse parser = argparse.ArgumentParser(description='我的程序描述', version='1.0.0') parser.add_argument('--version', action='version', help='显示版本信息')这样，当用户运行 --version 时，会自动输出 1.0.0。方法二：手动处理 --version 参数（更灵活）如果你需要从 __version__ 变量中获取版本号，可以这样做：import argparse __version__ = '1.0.0' parser = argparse.ArgumentParser(description='我的程序描述') parser.add_argument('--version', action='store_true', help='显示版本信息') args = parser.parse_args() if args.version: print(f'版本: {__version__}') exit()方法三：结合 argparse 和 pkg_resources 获取安装版本（适用于包发布）如果你的代码是作为 Python 包发布的，可以使用 pkg_resources 来获取实际安装的版本： import argparse import pkg_resources __version__ = pkg_resources.get_distribution('my_package').version parser = argparse.ArgumentParser(description='我的程序》，感兴趣的朋友请继续看下去吧！下文中的内容我们主要会涉及到等等知识点，如果在阅读本文过程中有遇到不清楚的地方，欢迎留言呀！我们一起讨论，一起学习！

argparse 的 --version 需手动传入版本号，推荐用 importlib.metadata.version('pkgname') 获取（Python 3.8+），并加 PackageNotFoundError 兜底；避免 pkg_resources 和硬编码 __version__，确保 pyproject.toml 中 [project].version 与安装一致。

argparse 如何让 --version 自动显示包版本号

argparse 怎么让 `--version` 显示当前包的版本号

默认情况下，argparse.ArgumentParser 的 add_argument('--version', action='version') 只能绑定一个固定字符串。要让它自动读取包的版本号（比如从 pyproject.toml 或 __version__），得手动把版本值传进去，不能靠 argparse 自动推导。

怎么获取并传入真实版本号

最稳妥的方式是提前从项目中读出版本号，再塞进 version 参数里。常见来源有：

import mypackage; mypackage.__version__ —— 要求包已安装或在 PYTHONPATH 中可导入
import importlib.metadata; importlib.metadata.version('mypackage') —— Python 3.8+，推荐，不依赖导入包本身
importlib.metadata.version(__name__.split('.')[0]) —— 如果脚本在包内，慎用，__name__ 可能是 __main__

示例：

import argparse
from importlib.metadata import version

parser = argparse.ArgumentParser()
parser.add_argument(
    '--version',
    action='version',
    version=f'mytool {version("mytool")}'
)