能否为Python argparse的-h选项自动输出追加内容？

当然可行！argparse早就为这种需求留好了口子，不用你费劲重写整个帮助体系——只要用好两个参数，就能轻松给自动生成的帮助信息加上概述和示例，完美对标man页面的风格。

第一步：用description添加前置概述 #

这个参数会把你写的文本放在自动生成的选项列表之前，用来给用户做整体功能介绍，和man页面的NAME/SYNOPSIS部分类似。比如：

import argparse

# 初始化解析器时传入description
parser = argparse.ArgumentParser(
    description="这是一个轻量级文本处理工具，专门用来分析日志、配置文件等文本内容。\n"
                "它默认忽略空行和以#开头的注释行，帮你快速提取有效信息。"
)

# 添加你的命令行参数
parser.add_argument("-f", "--file", required=True, help="要处理的目标文件路径")
parser.add_argument("-c", "--count", action="store_true", help="统计文件中的有效行数")
parser.add_argument("-k", "--keyword", help="提取包含指定关键词的行")

args = parser.parse_args()

运行python your_script.py -h时，这段概述会直接显示在参数列表的最前面，清晰告诉用户工具的用途。

第二步：用epilog添加末尾示例 #

如果想在帮助信息的最后加上类似man页面的EXAMPLES部分，就用epilog参数——它会把内容放在自动生成的选项列表之后。这里推荐用%(prog)s占位符，它会自动替换成你的脚本文件名，避免硬编码：

parser = argparse.ArgumentParser(
    description="这是一个轻量级文本处理工具，专门用来分析日志、配置文件等文本内容。\n"
                "它默认忽略空行和以#开头的注释行，帮你快速提取有效信息。",
    epilog="示例:\n"
           "  %(prog)s -f access.log -c\n"
           "    统计access.log中的有效行数（自动跳过空行和注释）\n"
           "  %(prog)s -f config.ini -k 'timeout'\n"
           "    从config.ini中提取所有包含'timeout'关键词的行"
)

这样用户看完参数说明后，能直接看到实际使用的例子，上手成本更低。

额外提示：格式自定义 #

如果需要调整换行、缩进，直接在字符串里加\n就行，argparse会保留这些格式。要是你需要更复杂的排版（比如加粗、分栏），那可能需要自定义HelpFormatter类，但对于大部分场景来说，description+epilog已经完全够用了，不用搞那么复杂。

内容的提问来源于stack exchange，提问作者bph