readline是最现实的命令行补全方案，因C++标准库不支持该功能，而readline经数十年验证，提供键绑定、历史、可编程补全；Windows需cygwin/MSYS2；注册补全须用C函数指针赋值rl_attempted_completion_function，不可用带捕获lambda；补全结果禁含空格；需正确设置rl_completer_word_break_characters；链接时注意ncurses依赖及readline版本兼容性。
为什么 readline 是最现实的选择
因为 C++ 标准库不提供命令行补全能力，自己解析 argv 并匹配历史/选项纯属重复造轮子；readline 是 Unix-like 系统上被验证数十年的方案，它直接接管输入流、支持键绑定、历史、可编程补全——而且你只需要写几行 C 风格回调。
注意：Windows 下需用 cygwin 或 MSYS2 提供的 readline，原生 Win32 控制台无等效替代；别试图用 std::getline + 自己做前缀匹配，那连 Tab 键响应都得从终端原始模式开始折腾。
怎么注册自定义补全函数（rl_attempted_completion_function）
关键不是“怎么写补全逻辑”，而是“怎么让 readline 调你”。必须用 C 函数指针赋值给全局变量 rl_attempted_completion_function，C++ 成员函数不能直接赋值——得用 static 全局函数或 lambda（带捕获的 lambda 不行，ABI 不兼容）。
-
rl_attempted_completion_function类型签名固定：char **func(const char *text, int start, int end)，返回NULL表示无匹配，否则返回malloc出的字符串数组（末尾为NULL） - 补全结果里不能带空格，否则
readline会截断；如果想补全路径，用rl_filename_completion_function更安全 - 别在回调里调
free()——readline内部会负责释放你返回的字符串数组和每个字符串
rl_completer_word_break_characters 改不对就补全失效
默认分隔符是 "
"\'`@$>，这意味着输入 ./foo<tab></tab> 时，text 参数传进来只是 foo，但如果你的命令格式是 cmd --opt=value<tab></tab>，就得把 = 加进这个字符串，否则 text 会是空或者错的片段。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
实操建议：
- 先打印当前值：
printf("break: %s ", rl_completer_word_break_characters); - 按需覆盖：
rl_completer_word_break_characters = const_cast<char>(" "\'`@$=;");</char>（注意 const_cast 是必要妥协） - 改完立刻测试交互行为——补全卡住、光标跳错、只补第一个词，八成是这个配置没对
链接和编译时容易漏掉的细节
看似 -lreadline 就完事，但实际常因依赖链断裂失败。Linux 上 readline 依赖 ncurses，Mac macOS 上则可能需要显式加 -lncurses；更隐蔽的是，某些发行版把 readline 拆成 libreadline.so.8，而头文件仍叫 readline/readline.h，链接时若只写 -lreadline 可能找不到。
稳妥做法：
- 检查头文件是否存在：
#include <readline/readline.h>和#include <readline/history.h> - 编译命令至少含：
g++ main.cpp -lreadline -lncurses（macOS 可省-lncurses，但加了不报错） - 运行时报
symbol lookup error: undefined symbol: rl_bind_key？说明动态库版本不匹配，用ldd ./a.out或otool -L ./a.out查真实依赖
补全逻辑本身可以很简单，但 readline 的胶水层稍有松动，整个交互就退化成裸 std::cin。真正卡住人的，永远是那些没报错、只默默不工作的配置点。
