getopt和手写argv解析不适用于结构体映射，因仅拆参不填结构，需手动if-else赋值，字段多或类型复杂时逻辑分散、易出错；真正省事的是编译期反射自动绑定字段元信息与命令行语义。
为什么 getopt 和手写 argv 解析不适用于结构体映射
因为它们只负责“拆参数”，不负责“填结构”。你得自己写一堆 if-else 或 switch 把 -p 8080 转成 cfg.port = 8080，一旦字段变多或类型混杂（比如 std::vector<:string></:string>、std::chrono::seconds），逻辑就散落在各处，改一个字段要动三处代码，还容易漏掉类型转换异常处理。
真正省事的方式，是让编译器/宏/模板知道“这个结构体字段对应哪个命令行选项”，然后自动生成解析逻辑。核心难点不在解析动作本身，而在如何把字段元信息（名字、类型、默认值、是否必需）和命令行语义（短选项、长选项、是否带参）绑定起来。
用 BOOST_DESCRIBE + 宏反射实现零运行时开销映射
Boost.Describe 提供编译期反射能力，但需要手动为结构体添加宏声明，且不支持嵌套结构体自动展开。它适合轻量级、静态配置场景，生成的解析代码完全内联，无虚函数或 map 查找开销。
- 结构体必须继承
boost::describe::describe_struct，字段名需字符串字面量对齐（比如字段叫timeout_s，描述里就得写"timeout_s"） - 每个字段需明确标注类型转换规则：内置类型（
int、bool）可直接用std::from_chars或std::stoul；自定义类型（如LogLevel）需提供from_string函数 - 长选项名默认用字段名转 kebab-case（
log_level→--log-level），短选项需显式指定，例如：BOOST_DESCRIBE_FIELD(cfg, log_level, (short_name, 'l')) - 错误提示靠
boost::mp11::mp_for_each遍历字段，在解析失败时拼接字段说明，不依赖运行时字符串 map
示例片段：
立即学习“C++免费学习笔记（深入）”；
struct Config {
int port = 8080;
std::string host = "127.0.0.1";
bool verbose = false;
};
BOOST_DESCRIBE_STRUCT(Config, (), (port, host, verbose))
遇到 std::optional 字段或重复参数（如 -v -v -v）怎么处理
标准命令行库（如 CLI11、cxxopts）默认不区分“未设置”和“设为空值”，而配置结构体里 std::optional<int> 的语义是“用户是否显式传了这个参数”。如果用 CLI11，必须配合 ->required(false)->default_value("") 并手动判断 count()；更稳妥的是在反射层加一层包装：
- 对
std::optional<T>字段，生成解析时检查该选项是否被命中（parsed.count("field") > 0），命中则调用T的转换，否则保持std::nullopt - 对计数型布尔字段（如
-v多次表示更详细日志），用int存储次数，解析时每匹配一次就++，不依赖std::string到bool的模糊转换 - 对
std::vector<std::string>，允许同一选项多次出现（--include a.h --include b.h），或接受逗号分隔值（--include=a.h,b.h），二者行为需在字段注解里明确，不能靠解析器猜测
别忽略 Windows 下 wmain 和宽字符路径问题
Windows 控制台默认用 CP_ACP 编码传参，中文路径或选项值（如 --path="C:\中文\config.json"）会被截断或乱码。即使你用 UTF-8 编译，main(int, char**) 拿到的仍是 ANSI 编码字节流。
正确做法是改用 wmain(int, wchar_t**)，并在入口立即调用 SetConsoleOutputCP(CP_UTF8) 和 SetThreadLocale(LOCALE_USER_DEFAULT)，再用 std::wstring_convert<std::codecvt_utf8<wchar_t>>（C++17 起已弃用，建议用 std::mbstowcs + std::wcsrtombs 或第三方库如 utf8cpp）转为 UTF-8 字符串后再进解析流程。这步漏掉，所有“自动映射”在中文环境里都是纸老虎。
结构体字段值本身不该存 wchar_t*，统一走 UTF-8 std::string，避免后续 JSON 序列化、日志打印、网络传输时反复转码。
