1. 什么是 fmt 库fmt是一个开源的 C 格式化库旨在提供一种快速、安全且易用的文本格式化方式以替代传统的printf和iostream。它最初由 Victor Zverovich 开发现已成为 C20 标准库format的基础。fmt 的核心优势包括类型安全编译时检查格式字符串与参数类型是否匹配避免运行时崩溃。高性能比std::stringstream和printf更快部分场景下甚至快一个数量级。易读易写使用类似 Python 的{}占位符语法直观清晰。扩展性强支持自定义类型的格式化。Unicode 友好天然支持宽字符和 UTF-8 编码。2. 快速开始2.1 安装与引入fmt 是一个仅有头文件的库可以通过多种方式集成到项目中包管理器如 vcpkg (vcpkg install fmt)、Conan (conan install fmt/10.0.0)。源码集成直接下载 GitHub 仓库 中的include/fmt目录。C20 及以上直接使用标准库format语法与 fmt 高度兼容。基本引入方式#include fmt/core.h // 核心功能 #include fmt/format.h // 完整格式化功能 #include fmt/ostream.h // 支持通过流输出自定义类型 // 或使用 C20 标准库 #include format2.2 第一个示例#include iostream #include fmt/core.h int main() { std::string name World; int year 2023; // 基础格式化 std::string msg fmt::format(Hello, {}! The year is {}., name, year); std::cout msg std::endl; // 直接输出到流 fmt::print(Hello, {}! The year is {}.\n, name, year); return 0; }输出Hello, World! The year is 2023. Hello, World! The year is 2023.3. 核心格式化功能3.1 基本占位符使用{}作为占位符按顺序匹配参数fmt::print({} {} {}\n, 2, 3, 5); // 2 3 5 fmt::print({1} comes before {0}\n, B, A); // A comes before B支持索引3.2 格式说明符在{}内使用:指定格式// 整数格式化 fmt::print(十进制: {}\n, 42); // 42 fmt::print(十六进制: {:x}\n, 255); // ff fmt::print(八进制: {:o}\n, 64); // 100 fmt::print(二进制: {:b}\n, 10); // 1010 fmt::print(科学计数: {:e}\n, 123.456); // 1.234560e02 // 浮点数 fmt::print(固定小数: {:.2f}\n, 3.14159); // 3.14 fmt::print(总宽度8: {:8.2f}\n, 3.14); // 3.14 // 字符串 fmt::print(左对齐: {:10}\n, test); // test fmt::print(右对齐: {:10}\n, test); // test fmt::print(居中对齐: {:^10}\n, test); // test 3.3 类型与安全检查fmt 在编译时检查格式字符串int num 42; std::string str hello; fmt::print({}\n, num); // OK // fmt::print({:s}\n, num); // 编译错误整数不能使用字符串格式符 fmt::print({}\n, str); // OK fmt::print({:s}\n, str); // OK4. 高级特性4.1 自定义类型格式化通过特化formatter模板为自定义类型添加格式化支持#include fmt/format.h struct Point { double x, y; }; template struct fmt::formatterPoint { // 解析格式说明符这里简单忽略 constexpr auto parse(format_parse_context ctx) { return ctx.begin(); } // 格式化函数 template typename FormatContext auto format(const Point p, FormatContext ctx) const { return format_to(ctx.out(), ({:.2f}, {:.2f}), p.x, p.y); } }; int main() { Point p{1.5, 2.5}; fmt::print(Point: {}\n, p); // Point: (1.50, 2.50) return 0; }4.2 内存安全与性能fmt 提供多种输出方式以适应不同场景// 1. 返回 std::string最常用 std::string s fmt::format(The answer is {}., 42); // 2. 输出到已有缓冲区避免内存分配 char buffer[100]; auto result fmt::format_to_n(buffer, sizeof(buffer), Hello, {}!, World); // 3. 输出到迭代器适用于容器 std::vectorchar vec; fmt::format_to(std::back_inserter(vec), Value: {}, 3.14); // 4. 直接输出到文件流 FILE* f fopen(output.txt, w); fmt::print(f, Writing to file: {}\n, 123);4.3 本地化与国际化fmt 支持本地化数字格式如千位分隔符#include fmt/locale.h std::locale loc(en_US.UTF-8); // 或 de_DE.UTF-8 fmt::print(loc, Number: {:,d}\n, 1000000); // Number: 1,000,0004.4 编译时格式字符串检查C20C20 的std::format和 fmt v10 支持编译时格式字符串// 使用 fmt::runtime() 关闭编译时检查动态格式字符串 std::string pattern {} {} {}; fmt::print(fmt::runtime(pattern), 2, 3, 5); // C20 编译时格式字符串类型安全 auto msg std::format(The value is {}, 42);5. 实战应用示例5.1 日志系统#include fmt/chrono.h #include fmt/color.h void log_info(const std::string msg) { auto now std::chrono::system_clock::now(); fmt::print(fg(fmt::color::green), [{}] INFO: {}\n, fmt::format({:%Y-%m-%d %H:%M:%S}, now), msg); } void log_error(const std::string msg) { fmt::print(fg(fmt::color::red) | fmt::emphasis::bold, ERROR: {}\n, msg); } int main() { log_info(Application started); log_error(File not found); return 0; }5.2 表格输出#include vector #include fmt/format.h struct Product { std::string name; double price; int quantity; }; void print_products(const std::vectorProduct products) { // 表头 fmt::print({:20} {:10} {:10}\n, Product, Price, Quantity); fmt::print({:-20} {:-10} {:-10}\n, , , ); // 数据行 for (const auto p : products) { fmt::print({:20} {:10.2f} {:10d}\n, p.name, p.price, p.quantity); } // 总计 double total 0; for (const auto p : products) { total p.price * p.quantity; } fmt::print({:-20} {:-10} {:-10}\n, , , ); fmt::print({:20} {:10.2f}\n, TOTAL, total); } int main() { std::vectorProduct products { {Laptop, 999.99, 2}, {Mouse, 29.99, 10}, {Keyboard, 79.50, 5} }; print_products(products); return 0; }6. 与标准库及其他方案的对比特性printfstd::stringstreamstd::format(C20)fmt类型安全❌ 运行时崩溃风险✅ 安全✅ 编译时检查✅ 编译时检查性能快慢快非常快语法简洁性一般冗长简洁简洁Unicode 支持有限良好良好优秀自定义类型❌ 不支持✅ 需重载✅ 需特化formatter✅ 需特化formatterC 版本要求CC98C20C117. 最佳实践与注意事项优先使用编译时格式字符串尽可能使用字面量字符串以获得类型安全和性能优势。避免不必要的字符串拷贝对于性能敏感场景使用fmt::format_to或fmt::memory_buffer。处理异常fmt 默认抛出异常可使用fmt::format_error捕获格式错误。迁移现有代码逐步替换printf和stringstream注意格式说明符的差异。版本兼容性注意 fmt v10 与早期版本的 API 变化特别是编译时格式字符串的引入。8. 总结fmt 库为 C 开发者提供了现代化、高性能的文本格式化解决方案。无论是简单的字符串拼接还是复杂的日志系统、报表生成fmt 都能以简洁安全的语法满足需求。随着 C20 将 fmt 的核心功能纳入标准库现在正是学习和采用这一技术的最佳时机。建议从fmt::format和fmt::print开始逐步探索自定义格式化、本地化等高级特性最终将 fmt 融入你的 C 工具箱中。