这个项目是一套关于 C++ 基础组件库的教程，记录了从零开始构建各种实用工具的完整过程。说实话，写这些教程的起因纯粹是因为我受够了每次写新项目都要到处找现成的库，要么依赖一大堆不想引入的东西，要么 API 设计得反人类。与其每次都妥协，不如花时间把手造轮子的过程搞清楚，以后就能按自己的需求定制了。
教程的特点是手把手带你走完整的设计和实现过程。我不会直接把代码扔给你然后说"就这样用"，而是会解释为什么要这样设计，每一步解决了什么问题，有哪些坑是踩过的。你会发现，这些看似简单的组件，背后其实藏着不少关于 API 设计、C++ 语言特性、软件架构的思考。
目前完成的系列包括 ArgParser 命令行参数解析器，后续还会继续添加更多实用组件的教程。
这个系列用七篇文章完整记录了一个命令行参数解析器的构建过程。你会在教程里看到如何从最初的一个简单想法，逐步演化成一个功能完整、代码优雅的工具库。整个过程没有用到什么高深的黑魔法，但涉及到了 C++ 的模板编程、STL 容器、异常处理、字符串处理等核心知识点。
如果你曾经写过那种满屏 if-else 处理命令行参数的代码，或者觉得现成的库要么太重要么 API 难用，这个教程应该会对你有所启发。更重要的是，通过这个过程，你会学会如何从需求出发设计数据结构，如何拆分复杂问题，如何权衡不同的实现方案。这些技能在写任何代码的时候都用得上。
| 章节 | 标题 | 内容概要 |
|---|---|---|
| 00 - 从零开始：为什么我们需要一个命令行解析器 | 动机篇 | 介绍命令行解析的通用需求，分析传统 if-else 方案的痛点，明确我们要实现的目标 |
| 01 - 数据结构先行：如何表示一个命令行参数 | 设计篇 | 设计 Arg 和 PosArg 结构体，选择合适的容器来存储参数定义和解析结果 |
| 02 - 注册接口：让用户描述参数 | 注册篇 | 实现 add_argument、add_flag、add_positional 三个注册函数，讨论 API 设计的语义清晰度 |
| 03 - 解析逻辑：从命令行输入到内部状态 | 解析篇 | 实现 parse 函数，处理 --help、--key=value、--key value、短参数、裸值等多种格式 |
| 04 - 读取接口：获取解析后的值 | 读取篇 | 实现模板函数 get 和 get_flag，支持从字符串到目标类型的转换 |
| 05 - 帮助信息：让工具更易用 | 帮助篇 | 实现 print_help 函数，自动生成格式化的使用说明 |
| 06 - 实战演练：完整的使用示例 | 实战篇 | 用一个完整的 demo 展示 ArgParser 的使用方式，测试各种场景 |
| 07 - 设计复盘：权衡与扩展方向 | 回顾篇 | 总结整个设计的权衡取舍，讨论默认值、多值参数、子命令等扩展方向 |