子命令 help 不显示是因为 add_parser() 未传 help 参数；需为每个子命令显式指定 help=字符串以控制汇总页说明，再用 description 和 RawDescriptionHelpFormatter 定制详情页格式。
子命令 help 描述不显示？检查
参数是否传给了
默认情况下，
创建的子命令解析器不会自动显示描述，除非你在调用
时显式传入
字符串。很多人只给子命令设置了
或
，但这些不影响
汇总页里的那一行简短说明。
正确做法是：
← 这个
才控制汇总页显示
想让子命令详情页也更友好？用
和
子命令自身的
（比如运行
）默认只显示参数，不带顶层描述。要让它显示说明文字，得在
里加
：
注意：
能保留换行和缩进，否则多行
会被压成一行。
避免 help 文本被截断或重复？别在
里设
本身不接受
参数 —— 如果你强行写了，argparse 会静默忽略，还可能触发
（取决于 Python 版本）。
elasticsearch-9.4.0 win
PHP中文网提供Elasticsearch 9.4.0 Windows 版本压缩包下载解压即用，内置 OpenJDK 无需额外配置 Java 环境。该版本重磅推出原生 Prometheus 支持、正式版 Elastic Workflows 以及基于 NVIDIA cuVS 的 GPU 加速向量索引，大幅提升 AI 检索与可观测性能力。建议前往官网下载，快速体验极速搜索与强大的数据分析功能。
下载
常见误写：
中文 help 显示乱码？确认终端和 Python 文件
编码
如果
字符串含中文但在终端里显示为
或空格，问题通常不在 argparse，而在环境：
Python 源文件开头没加
Windows cmd 默认编码是 gbk，而 Python 3.7+ 的 argparse 内部用 utf-8 渲染 help —— 此时需设置
环境变量
或改用 Windows Terminal / WSL
IDE（如 PyCharm）终端编码设置不是 UTF-8
验证方式：打印
，它应为
；如果不是，help 中文基本注定显示异常。
子命令 help 的定制关键就两点：每个
必须带
，且描述性文字要靠
+ 合适的
控制格式。漏掉前者，汇总页就空着；忽略后者，子命令详情页就干巴巴。
helpadd_parser()add_subparsers()add_parser()help=descriptionepilog--helpsubparsers = parser.add_subparsers(dest="command")sub_a = subparsers.add_parser("train", help="训练模型（支持 CPU/GPU）")helpsub_a.add_argument("--lr", type=float, default=1e-3)descriptionformatter_class--helppython script.py train --helpadd_parser()descriptionsub_a = subparsers.add_parser(
"train",
help="训练模型（支持 CPU/GPU）",
description="使用指定数据集和超参训练深度学习模型，支持断点续训。",
formatter_class=argparse.RawDescriptionHelpFormatter
)RawDescriptionHelpFormatterdescriptionadd_subparsers()helpadd_subparsers()helpTypeError: add_subparsers() got an unexpected keyword argument 'help'# ❌ 错误：add_subparsers 不吃 help 参数
subparsers = parser.add_subparsers(help="可用操作", dest="command")
✅ 正确：help 只属于每个子解析器
subparsers = parser.add_subparsers(dest="command")
help# -*- coding: utf-8 -*-chcp 65001sys.stdout.encodingutf-8add_parser()help=descriptionformatter_class