getopt 不够用因其仅支持短选项、无长选项解析、不自动生成帮助文本且无法映射为 std::map；需声明式定义选项并自动解析、填充、对齐输出help。
为什么 getopt 不够用？
因为 getopt 只处理短选项（-h、-o file.txt），不支持长选项（--help、--output=file.txt），也不自动生成帮助文本，更不会把参数映射成 std::map<:string std::string></:string>。你得手动维护选项列表、写 help 字符串、再逐个判断 optarg——一改就漏，一加就崩。
真正要的是：声明式定义选项 → 自动解析 → 自动填充 Map → 自动输出对齐的 help。
- 用
std::vector存选项元信息（名称、是否必需、默认值、描述） - 解析时按
--key=value或--key value两种格式统一归一化 - 遇到未知选项或缺失必需参数，立刻报错并退出，不继续执行
- help 文本按最长键名自动对齐，避免手写空格错位
如何用 std::map 接收解析结果？
别直接往 std::map 里塞原始 argv 字符串——类型不安全，且无法表达“未提供但有默认值”的语义。应该先定义结构体承载每个选项的完整契约：
struct Option {
std::string long_name;
bool required = false;
std::string default_value;
std::string description;
};
然后在解析完成后，用这个结构体列表驱动填充最终的 std::map<:string std::string></:string>：
立即学习“C++免费学习笔记（深入）”；
- 遍历所有已声明的
Option，若命令行提供了该 key，则取其值；否则取default_value；若required == true且未提供，直接报错 - Map 的 key 是
long_name（如"output"），不是"--output"，方便后续业务代码直接用opts["output"] - 注意：同一个 key 出现多次时，以最后一次为准（符合大多数 CLI 工具行为）
怎么让 help 输出自动对齐、不靠手敲空格？
硬写 " --verbose Enable verbose output\n" 很容易错位，尤其加了新选项后全乱。正确做法是先扫描所有 long_name 长度，算出最大宽度，再用 std::setw 动态对齐：
int max_len = 0;
for (const auto& opt : options) {
max_len = std::max(max_len, static_cast<int>(opt.long_name.length()));
}
for (const auto& opt : options) {
std::cout << " --" << std::left << std::setw(max_len + 1) << opt.long_name
<< opt.description << "\n";
}
- 别忘了给长选项加
--前缀，短选项加-前缀（如果同时支持） - 必需参数后面标
[required]，有默认值的标[default: xxx]，一眼可知行为 - help 最后一行输出
"Usage: " + argv[0] + " [OPTIONS]"，别漏可执行名
遇到 -- 分隔符和位置参数怎么处理？
很多工具支持 cmd --flag -v file1 file2，其中 file1 file2 是位置参数（positional arguments），不应被当作选项解析。标准做法是识别 -- 作为分隔符：
- 遇到
--后，停止解析选项，后续所有 token 全部视为位置参数 - 没遇到
--时，仍需支持cmd -f file.txt --verbose这种混合写法 - 位置参数单独存入
std::vector<:string></:string>，不进主 Map，避免 key 冲突（比如用户传了个叫"--output"的文件名） - 解析完立即校验：若声明了必需的位置参数（如至少一个输入文件），但
positional_args.empty()，报错退出
真正的难点不在解析逻辑本身，而在错误提示的粒度——是只说“invalid argument”，还是精确指出“missing required option '--input'”？后者才能让人少查三分钟文档。
