C++轻量命令行参数解析库通过声明式API将argc/argv映射为结构化配置，支持短/长选项、带值参数、布尔开关及位置参数，纯std实现、零依赖、自动帮助生成与类型安全转换。
用 C++ 实现一个轻量、易用的命令行参数解析库，核心是把 argc / argv 映射成结构化配置，支持短选项（-h）、长选项（--help）、带值参数（--port 8080 或 --port=8080）、布尔开关和位置参数。不需要依赖第三方（如 Boost.Program_options），纯 std 实现即可，关键在设计清晰、容错友好、扩展方便。
基础接口设计：声明即配置
让用户用类似“声明式”的方式定义参数，避免手动遍历 argv。例如：
这样写完就自动支持 ./app -h、./app --port=9000 --name=alice 等多种写法。内部用 std::vector 存注册项，每个项含别名字符串、描述、默认值、是否已设置标记等。
解析逻辑：一次遍历 + 状态机驱动
不递归、不回溯，从 argv[1] 开始逐个扫描，用简单状态区分：当前是否在读取某个选项的值、是否遇到 -- 分隔符、是否为位置参数。关键点有：
立即学习“C++免费学习笔记（深入）”；
- 遇到
-X或--xxx，先查注册表；匹配失败则报错或跳过（可配严格模式） - 若该参数需值（如
int），下一项必须是值，或当前项含=（如--port=8080） -
-abc视为多个单字符选项（-a -b -c），但仅当它们都注册为 flag 或无参 option 时才合法 - 遇到
--后，后续全作位置参数，不再解析为选项
类型安全与转换：模板 + std::from_chars / stringstream 回退
对 add_option<t>()</t>，优先用 std::from_chars（C++17，快且不抛异常）做整数/浮点解析；失败则用 std::stringstream 尝试（兼容自定义类型，只要支持 operator>>）。布尔类型直接识别 "true"/"false"、"on/off"、"1/0" 和空值（-v 即 true）。所有转换错误统一抛 std::runtime_error，由用户 try/catch。
实用增强：帮助生成与错误提示
调用 config.help() 自动输出对齐格式的帮助文本，包括所有选项、别名、默认值和说明。错误提示要具体，比如：
还可加 config.positional("input_file", "input path") 支持固定顺序的位置参数，并在解析后提供 config.get_positional(0) 访问。
基本上就这些——不复杂但容易忽略的是边界处理：空参数、重复选项、值缺失、编码无关（只处理 ASCII 选项名）、线程不安全（本就是 main 单次使用）。封装成头文件库，#include "args.h" 即用，零编译依赖。
