用宏+成员指针在编译期注册字段元信息，运行时遍历生成 help；需自研解析器映射命令行到结构体字段，按定义顺序排版三段式 help（选项、默认值、说明），bool 参数分 --x/--no-x 两行展示，默认值栏写 off/on。
用 struct 描述参数后，怎么让程序自动打印 help？
核心是别手写 help 字符串——结构体字段本身就能携带帮助信息。C++ 没原生反射，但可以用宏 + 成员指针 + 初始化列表，在编译期“注册”每个字段的名称、类型、默认值和说明，运行时遍历生成 help 文本。
典型错误是把 help 逻辑硬编码在 main() 里，导致新增参数时总忘改 help；或者用注释写说明，完全没法自动提取。
- 每个参数字段必须是 public，且类型可判别（如
int、std::string、bool） - help 文本生成函数需能读取字段名（用
BOOST_PP或 C++20std::source_location配合宏获取） - 推荐用宏包裹结构体定义，例如
DEFINE_CLI_ARGS(MyArgs, (int, port, 8080, "server port") (std::string, host, "localhost", "target hostname"))
std::getopt 和自定义解析器谁更适合配合结构体生成 help？
std::getopt 不适合——它不保存参数元信息，只返回选项字符，无法反查字段名或说明。必须自己实现轻量解析器，把命令行字符串映射到结构体字段，并在映射过程中顺带收集 help 所需数据。
常见坑：用 std::map<:string std::any></:string> 存参数值，看似灵活，但丢失了字段顺序和类型语义，help 排版混乱，也无法校验必填项。
立即学习“C++免费学习笔记（深入）”；
- 解析器应接受结构体引用（如
MyArgs& args），通过成员指针直接赋值 - help 输出顺序应与结构体定义顺序一致，靠宏展开顺序或
std::tuple成员索引保证 - 短选项（
-h）和长选项（--help）都应支持，且 help 内容需统一来源，避免两套描述
如何让 help 输出对齐、可读、不崩格式？
纯拼接字符串容易错位，尤其当参数名长度差异大或说明含换行时。关键是把 help 行拆成三段：选项标识、默认值、说明，并用固定宽度左对齐+右对齐组合排版。
典型错误是用 \t 制表符——不同终端 tab 宽度不一，help 在 CI 日志或 Windows 控制台里全乱。
- 选项列宽度取所有
-x, --xxx最大长度 + 4（留空格） - 默认值列用
std::setw固定宽度，右对齐，空默认值显示为(required) - 说明文本手动按行宽（如 60 字符）折行，每行缩进 2 空格，不用
std::endl换行符干扰管道输出
-h, --help (none) Show this help message -p, --port 8080 Server listening port -H, --host localhost Target hostname to connect to
bool 类型参数的 help 怎么写才不误导用户？
用户看到 --verbose true 就会困惑：是不是必须跟值？其实 bool 参数应支持开关式用法（--verbose 启用，--no-verbose 禁用），help 必须明确体现这种语义，不能只写“enable verbose mode”。
更隐蔽的坑是结构体里用 bool verbose = false;，但解析器没区分“未出现”“显式设为 false”“显式设为 true”，导致 help 里写“default: false”却无法表达开关行为。
- bool 字段在 help 中应分两行：一行写启用开关（
--verbose），一行写禁用开关（--no-verbose） - 解析器需识别
--no-*前缀，并映射到同一字段，而不是新增一个no_verbose字段 - help 中 bool 项的默认值栏统一写
off或on，不写true/false
./mytool --help | head -n5 验证。 
