C++命令行工具：gflags与spdlog实战

好的，这是一个关于 gflags 和 spdlog 在 C++ 项目中协同使用的实战指南。它们分别擅长处理命令行参数解析和高性能日志记录，是开发命令行工具的强力组合。

核心组件简介

实战步骤：集成与最佳实践

步骤 1: 安装依赖

确保项目中已包含 gflags 和 spdlog。可以通过包管理器（如 vcpkg, conan）或源码集成。

步骤 2: 定义命令行参数 (gflags)

在你的主程序（如 main.cpp）中定义需要的参数：

#include <gflags/gflags.h>

// 定义参数及其类型、默认值、帮助信息
DEFINE_bool(verbose, false, "Enable verbose output"); // 布尔型
DEFINE_string(logfile, "", "Path to log file (default: stdout)"); // 字符串型
DEFINE_int32(port, 8080, "Listening port"); // 整型

步骤 3: 解析命令行参数 (gflags)

在 main 函数开始处解析命令行参数：

int main(int argc, char** argv) {
// 解析命令行参数，处理 –help
gflags::ParseCommandLineFlags(&argc, &argv, true);

// 你的应用程序逻辑从这里开始…
// 访问参数: FLAGS_verbose, FLAGS_logfile, FLAGS_port

return 0;
}

步骤 4: 初始化日志系统 (spdlog)

根据 gflags 参数配置 spdlog：

#include <spdlog/spdlog.h>
#include <spdlog/sinks/stdout_color_sinks.h>
#include <spdlog/sinks/basic_file_sink.h>
#include <memory>
#include <vector>

int main(int argc, char** argv) {
gflags::ParseCommandLineFlags(&argc, &argv, true);

// 1. 创建日志接收器 (sinks)
std::vector<spdlog::sink_ptr> sinks;

// 控制台接收器 (总是启用)
auto console_sink = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();
sinks.push_back(console_sink);

// 文件接收器 (如果指定了 logfile 参数)
if (!FLAGS_logfile.empty()) {
try {
auto file_sink = std::make_shared<spdlog::sinks::basic_file_sink_mt>(FLAGS_logfile, true);
sinks.push_back(file_sink);
} catch (const spdlog::spdlog_ex& ex) {
// 处理文件打开失败
std::cerr << "Log file init failed: " << ex.what() << std::endl;
}
}

// 2. 创建组合接收器的日志器
auto logger = std::make_shared<spdlog::logger>("main", begin(sinks), end(sinks));

// 3. 设置全局日志级别 (根据 verbose 参数)
if (FLAGS_verbose) {
logger->set_level(spdlog::level::debug); // 详细模式显示 debug 及以上
logger->flush_on(spdlog::level::debug); // 遇到 debug 及以上级别立即刷新
} else {
logger->set_level(spdlog::level::info); // 默认显示 info 及以上
logger->flush_on(spdlog::level::warn); // 遇到 warn 及以上级别立即刷新
}

// 4. 注册为全局日志器 (可选，方便使用 spdlog::info() 等)
spdlog::set_default_logger(logger);

// 5. 设置日志格式 (可选)
spdlog::set_pattern("[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] [thread %t] %v");

// 示例日志输出
SPDLOG_INFO("Application starting, port: {}", FLAGS_port);
SPDLOG_DEBUG("This is a debug message (only visible if –verbose is set)");

// … 应用程序逻辑

// 程序退出前确保日志刷新
spdlog::shutdown();
return 0;
}

http://my.tv.sohu.com/us/441086388/700128285.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODI4NS5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128165.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODE2NS5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128170.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODE3MC5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128178.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODE3OC5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128339.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODMzOS5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128184.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODE4NC5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128509.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODUwOS5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128434.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODQzNC5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128520.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODUyMC5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128199.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODE5OS5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128442.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODQ0Mi5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128526.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODUyNi5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128610.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODYxMC5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128369.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODM2OS5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128538.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODUzOC5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128453.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODQ1My5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128553.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODU1My5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128469.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODQ2OS5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128476.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODQ3Ni5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128644.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODY0NC5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128713.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODcxMy5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128724.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODcyNC5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128814.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODgxNC5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128691.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODY5MS5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128750.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODc1MC5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700129011.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyOTAxMS5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128842.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODg0Mi5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700129022.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyOTAyMi5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128776.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODc3Ni5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128943.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODk0My5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128784.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODc4NC5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128859.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODg1OS5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128946.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODk0Ni5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128787.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODc4Ny5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128872.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODg3Mi5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700129062.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyOTA2Mi5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128965.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODk2NS5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700129066.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyOTA2Ni5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700129112.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyOTExMi5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700128984.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyODk4NC5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700129217.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyOTIxNy5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700129134.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyOTEzNC5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700129405.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyOTQwNS5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700129322.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyOTMyMi5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700129151.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyOTE1MS5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700129341.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyOTM0MS5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700129258.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyOTI1OC5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700129170.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyOTE3MC5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700129359.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyOTM1OS5zaHRtbA==.html
http://my.tv.sohu.com/us/441086388/700129178.shtml
https://tv.sohu.com/v/dXMvNDQxMDg2Mzg4LzcwMDEyOTE3OC5zaHRtbA==.html
 

步骤 5: 在代码中使用日志

使用 spdlog 的宏进行日志记录：

void process_data(const std::string& data) {
SPDLOG_INFO("Processing data: {}", data);
try {
// … 业务逻辑
SPDLOG_DEBUG("Step 1 completed");
// … 更多逻辑
} catch (const std::exception& e) {
SPDLOG_ERROR("Error processing data: {}", e.what());
throw;
}
SPDLOG_INFO("Data processed successfully");
}

步骤 6: 编译与运行

编译程序并链接 gflags 和 spdlog 库。运行时可使用 gflags 定义的参数：

# 默认运行 (日志级别 info, 输出到控制台)
./myapp

# 启用详细日志 (debug 级别)
./myapp –verbose

# 指定日志文件
./myapp –logfile=app.log

# 同时指定
./myapp –verbose –logfile=debug.log –port=9090

# 查看帮助信息
./myapp –help

性能优化建议

总结

结合 gflags 和 spdlog 提供了：

• 强大的命令行配置: 通过 gflags 轻松管理启动参数。
• 灵活高效的日志: 通过 spdlog 实现高性能、可定制的日志记录，日志行为可由命令行参数动态控制（如级别、输出目标）。
• 清晰的代码: 参数定义和日志初始化集中管理，业务代码专注于核心逻辑和清晰的日志记录。

这种组合非常适合开发需要灵活配置和高性能日志记录的命令行工具和服务。