C++ 命令行参数解析原理与实现。涵盖 argc/argv 机制、长选项、键值对及位置参数处理。通过手写 CommandLineParser 类封装逻辑，提供查询接口与帮助打印功能。代码基于 C++17，无第三方依赖，结构清晰，适用于工具开发模板或教学示例。
在现代软件工程中，**命令行程序（CLI Program）**仍然占据着极其重要的地位。 即使在 GUI、Web、云原生盛行的今天，命令行程序依然是：
而命令行参数（Command Line Arguments），正是 CLI 程序与用户交互的最基本机制。
当我们在终端中输入：
./app --input data.txt --threads 8 --verbose操作系统会在程序启动时，将这些参数：
传递给 main 函数。
在 C/C++ 中，其标准形式为：
int main(int argc, char* argv[])
其中：
argc（argument count）：参数个数argv（argument vector）：参数字符串数组很多初学者只知道：
argv[1] argv[2]
却忽略了以下关键问题：
--key=value？--help？本文的目标是： 从'操作系统层面' → 'C++ 层面' → '工程化封装'，完整讲清楚命令行参数检索与解析。
本项目并不是'只演示 argc / argv'，而是一个教学级 CLI 参数解析示例。
实现一个 C++ 命令行程序，支持：
input.txt--input file.txt--threads=8--verbose--help 打印说明当你在终端执行程序时：
argv[]在 C++ 中，你看到的：
argv[0] // 程序路径 argv[1] // 第一个用户参数 ...
⚠️ 注意：
argv[0] 永远存在argc >= 1int main(int argc, char* argv[])
或：
int main(int argc, char** argv)
二者完全等价。
| 风格 | 示例 |
|---|---|
| 位置参数 | app input.txt |
| 短选项 | -v |
| 长选项 | --verbose |
| 键值对 | --threads 8 |
| 等号 | --threads=8 |
虽然有：
getoptBoost.Program_optionsCLI11但教学与底层理解阶段，手写解析器能：
设计一个简单的 CommandLineParser 类：
argc / argvhas_optionget_optionget_positional_args--key=value → 拆分为 key/value--key value → 读取下一个参数--flag → 布尔 true- 开头 → 位置参数--help → 立即打印说明并退出/************************************************************
* File: command_line_demo.cpp
* Description:
* Demonstration of command line argument retrieval
* and parsing in C++ (C++17)
************************************************************/
#include <iostream>
#include <string>
#include <unordered_map>
#include <vector>
/********************* CommandLineParser *********************/
class CommandLineParser {
public:
CommandLineParser(int argc, char* argv[]) {
parse(argc, argv);
}
// 判断某个选项是否存在（如 --verbose）
bool has_option(const std::string& name) const {
return options_.count(name) > 0;
}
// 获取选项值（如 --threads=8）
std::string get_option(const std::string& name, const std::string& default_value) const {
auto it = options_.find(name);
if (it != options_.end()) {
return it->second;
}
return default_value;
}
// 获取所有位置参数
const std::vector<std::string>& positional_args() const {
return positional_;
}
private:
std::unordered_map<std::string, std::string> options_;
std::vector<std::string> positional_;
void parse(int argc, char* argv[]) {
for (int i = 1; i < argc; ++i) {
std::string arg = argv[i];
// 长选项 --key=value
if (arg.rfind("--", 0) == 0) {
auto pos = arg.find('=');
if (pos != std::string::npos) {
std::string key = arg.substr(2, pos - 2);
std::string value = arg.substr(pos + 1);
options_[key] = value;
} else {
std::string key = arg.substr(2);
// 判断下一个是否为值
if (i + 1 < argc && argv[i + 1][0] != '-') {
options_[key] = argv[++i];
} else {
// 作为布尔开关
options_[key] = "true";
}
}
}
// 位置参数
else {
positional_.push_back(arg);
}
}
}
};
/********************* Helper Function *********************/
void print_help() {
std::cout << "Usage:\n"
<< " app [options] <input>\n\n"
<< "Options:\n"
<< " --input <file> Input file\n"
<< " --threads <n> Number of threads\n"
<< " --verbose Enable verbose output\n"
<< " --help Show this help\n";
}
/**************************** Main ***************************/
int main(int argc, char* argv[]) {
CommandLineParser parser(argc, argv);
if (parser.has_option("help")) {
print_help();
return 0;
}
std::string input = parser.get_option("input", "default.txt");
int threads = std::stoi(parser.get_option("threads", "1"));
bool verbose = parser.has_option("verbose");
std::cout << "Input file : " << input << std::endl;
std::cout << "Threads : " << threads << std::endl;
std::cout << "Verbose : " << (verbose ? "true" : "false") << std::endl;
const auto& pos = parser.positional_args();
for (size_t i = 0; i < pos.size(); ++i) {
std::cout << "Positional[" << i << "] = " << pos[i] << std::endl;
}
return 0;
}
CommandLineParser 构造函数argc / argvhas_optionget_optionif (argc > ...) 判断parse--key=value--key value--flagprint_help通过本项目，你已经掌握了：
这套代码可以直接作为：
getopt？-v？parse 中增加对 - 前缀的判断即可-h -vBoost.Program_options
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online