当前位置：首页 > news >正文

《commander-cpp》单头文件的、链式调用的、自动生成帮助文档的C#x2B；#x2B；命令行参数解析库

news 2026/4/7 19:29:07

《commander-cpp》单头文件的、链式调用的、自动生成帮助文档的C++命令行参数解析库

前言

作者我本人经常会写一些命令行小工具，
此前一直使用node.js的三方库commander.js来解析命令行参数,
commander.js是一个非常方便的命令行参数解析库，
但是使用node.js也会有一些限制，比如：运行的电脑上需要安装node.js，并且在一些对性能要求比较高的场景就会不太方便了，
针对上述情况，我尝试切换到c++，但是在实际写代码时发现，现有的命令行解析库使用时没有commander.js那么丝滑，让我很难受，
于是，我决定仿照commander.js的设计，写一个c++的命令行参数解析库，取名为commander-cpp，头文件名为commander_cpp.hpp

仓库

仓库地址：https://github.com/DoYoungDo/commander-cpp

特性

🎯 链式 API 设计，简洁易用
📦 单头文件，无外部依赖
🔧 支持选项（单值、多值、布尔值）
📝 支持参数（必需参数、可选参数、多值参数）
🌲 支持子命令和嵌套命令
⚙️ 支持默认值
📖 自动生成帮助信息
🔍 详细的错误处理和日志系统
🎨 支持选项别名和组合（如-abc）

安装

将commander_cpp.hpp文件复制到项目中，并在代码中包含它：

/* by 01130.hk - online tools website : 01130.hk/zh/html2cj.html */ #include "commander_cpp.hpp"

示例

示例代码

/* by 01130.hk - online tools website : 01130.hk/zh/html2cj.html */ #include "commander_cpp.hpp" using namespace COMMANDER_CPP; int main(int argc, char **argv) { // 构造一个Command对象，命令名为"example", 等价于：Command().name("example") Command("example") // 设置版本号 .version("1.0.0") // 添加一个简介描述文本 ->description("一个示例命令行应用") // 添加一个选项，选项名是'name',设置别名'n',并指定参数必选 ->option("-n --name <name>", "你的名字" /* 选项的描述 */) // 添加一个参数，参数名是'file',并指定参数可选 ->argument("[file]", "要处理的文件路径") // 添加一个动作回调，当命令行参数解析完成后调用 ->action([](Vector<Variant/* = std::variant<...> */> args /* 参数值列表 */, Map<String /* 选项名 */, Variant /* 选项值 */> opts /* 选项值列表 */) { if (opts.find("name") != opts.end()) { std::cout << "Hello, " << std::get<String>(opts["name"]) << "!" << std::endl; } else { std::cout << "Hello, World!" << std::endl; } }) // 解析命令行参数 ->parse(argc, argv); return 0; }

运行示例

$ ./example -n Alice Hello, Alice! $ ./example -V 1.0.0 $ ./example --help Usage: example [options] 一个示例命令行应用 Options: -V, --version out put version number. -n, --name <name> 你的名字 -h, --help

更多示例...