fmt：C++ 格式化的事实标准库

核心判断

如果你在写 C++ 且还在用 printf 或 iostreams 做字符串格式化，{fmt} 是最直接的升级路径。它比两者都快（数值格式化场景比 iostreams 快 20–30 倍），完全类型安全，格式串错误在编译期报错，最小配置只需三个头文件。更重要的是它的行业地位：C++20 标准库的 std::format 和 C++23 的 std::print 就是以它为蓝本制定的——学 {fmt} 等于提前用上了下一代标准库，还附带标准库没有的颜色输出、编译期格式串编译（FMT_COMPILE）等能力。

截至本文写作时，仓库约 25.6k stars，MIT 许可，无外部依赖。用户名单足以说明其生产成熟度：PyTorch、ClickHouse、MongoDB、FoundationDB、Windows Terminal、spdlog、Envoy、Folly、Ceph、MariaDB、Blizzard Battle.net。

为什么不用 printf / iostreams

三个老方案的痛点 {fmt} 逐一解决：

一个直观的对比数据（README 引用 format-benchmark，Apple M5 Max / Apple Clang 21，-O3，100 个翻译单元各调用 5 次）：printf 编译 1.2s、产物 54 KiB；iostreams 编译 21.8s、98 KiB；{fmt}（版本 12.2）编译 4.2s、54 KiB；Boost Format 1.88 编译 43.4s、550 KiB。{fmt} 的编译速度和二进制尺寸都与 printf 打平，同时保留了完整的类型安全和现代语法。

格式语法：Python 风格

核心语法接近 Python 的 str.format：

#include <fmt/base.h>

int main() {
  fmt::print("Hello, world!\n");
}

std::string s = fmt::format("The answer is {}.", 42);
// s == "The answer is 42."

// 位置参数（本地化场景）
std::string s = fmt::format("I'd rather be {1} than {0}.", "right", "happy");
// s == "I'd rather be happy than right."

花括号本身是字面量时用双写转义：fmt::format("{{{}}}", 42) 输出 {42}。命名参数按名字引用，适合格式串和实参分离的写法：

std::string s = fmt::format("{name} was born in {year}.",
                            fmt::arg("name", "Ada"), fmt::arg("year", 1815));
// s == "Ada was born in 1815."

格式规格：冒号后面才是真正的表达能力

{...} 内冒号后的部分称为格式规格，控制对齐、宽度、精度与进制。常用组合不多，一张表够用：

宽度可以用嵌套参数动态指定：fmt::format("{:{}}", "abc", 10)。零填充只对数值生效，且遇到对齐符会失效。字符串默认左对齐、数字默认右对齐，这是最容易记错的一点。

编译期检查：错误在 build 时暴露

std::string s = fmt::format("{:d}", "I am not a number");

这一行在 C++20 下直接编译失败——d 对字符串是非法格式符。对比 printf 的同类错误（%d 传字符串）要到运行时才崩，这是安全模型上的代差。

运行时格式串：显式标记，不默认放开

编译期检查的前提是格式串是字面量。当格式串来自运行时（配置项、用户输入、从别处读来的字符串），需要显式声明放弃编译期检查：

std::string s = fmt::format(fmt::runtime(fmt_string), 42);

这个设计值得注意：{fmt} 没有像 printf 那样默认接受任意字符串当格式串，而是要求你用一个 fmt::runtime 包装来"主动选择"运行时解析。效果是——误把变量当格式串传给 fmt::format 会直接编译失败，而不是留到运行期出错；反过来，真正需要动态格式串的代码点变得可检索。格式串本身的错误（如宽度非法、参数类型不匹配）在运行时抛 fmt::format_error，可捕获处理。

常用能力速览

日期时间（fmt/chrono.h）：

auto now = std::chrono::system_clock::now();
fmt::print("Time: {:%H:%M}\n", now);

容器直接打印（fmt/ranges.h）：

std::vector<int> v = {1, 2, 3};
fmt::print("{}\n", v);  // [1, 2, 3]

彩色与文本样式（fmt/color.h）：

fmt::print(fg(fmt::color::crimson) | fmt::emphasis::bold,
           "Hello, {}!\n", "world");

写入已有缓冲区（fmt/format.h 的 fmt::format_to / fmt::format_to_n）：不想产生中间 std::string、想复用栈上缓冲时用它。format_to 返回写入末尾的迭代器；固定大小数组用 format_to_n，带容量参数，避免溢出：

char buf[64];
auto result = fmt::format_to_n(buf, sizeof(buf), "{} + {} = {}", 1, 2, 3);
std::string_view sv(buf, result.size);
// sv == "1 + 2 = 3"

单线程写文件（fmt/os.h）：fmt::output_file("guide.txt") 返回的 writer 比多次调用 fprintf 快最多 9 倍（官方 benchmark 数据，来自缓冲区尺寸优化）。

用户自定义类型：为自己的类型实现 formatter 特化即可接入全部格式语法——这是 printf 家族做不到的扩展点。

浮点：Dragonbox 算法

浮点转字符串是格式化库的硬骨头。{fmt} 使用 Dragonbox 算法，同时保证正确舍入、最短表示、往返一致（round-trip：打出来再解析回去得到同一个 double）。这是它比 sprintf 系实现快一个量级的核心来源之一，benchmark 见仓库 dtoa-benchmark。

集成方式

• CMake FetchContent / find_package(fmt) 常规接入
• 最小配置：只拷 base.h、format.h、format-inl.h 三个文件
• 定义 FMT_HEADER_ONLY 宏启用 header-only 模式
• 无外部依赖，MIT 许可；-Wall -Wextra -pedantic 下无警告
• 持续接入 OSS-Fuzz 长期模糊测试（README 明确声明），安全性有外部验证

验证步骤：十分钟跑通

想亲手确认"编译期报错"和性能数据，不需要搭工程。最快路径：打开 README 里的 Compiler Explorer 链接，fmt::format("{:d}", "x") 直接看编译失败；把 {:d} 换成 {} 即可通过。本地验证用两条命令：

# 任意目录，三文件最小配置
mkdir -p demo && cd demo
cp <fmt>/include/fmt/base.h <fmt>/include/fmt/format.h <fmt>/include/fmt/format-inl.h .
cat > main.cpp <<'EOF'
#include <fmt/format.h>
#include <cstdio>
int main() {
  std::string s = fmt::format("{:>8.2f} | {:08d}", 3.14159, 42);
  std::puts(s.c_str());  // "    3.14 | 00000042"
}
EOF
g++ -std=c++20 main.cpp && ./a.out

main.cpp 里的格式串可以替换成编译期检查一节那个故意写错的版本，体会"构建时失败"和"运行时崩溃"的差别。

与 std::format 的关系

std::format（C++20）与 std::print（C++23）以 {fmt} 为参考实现进入标准。如果你的工具链已支持，标准库版本可以满足基本需求；{fmt} 的增量价值在于：更早的编译器支持（{fmt} 兼容老编译器）、FMT_COMPILE 编译期格式化、颜色/样式、ranges、chrono 扩展，以及在新标准落地前的过渡期。官方提供 Compiler Explorer 在线体验与 fmt.dev 完整文档。

适用边界

{fmt} 不解决本地化格式（默认 locale 无关，本地化通过位置参数支持）；极少数需要与既有 printf 格式串完全兼容的场景可以用它的安全 printf 实现（含 POSIX 位置参数扩展），但新代码不建议再写 printf 风格。

常见问题

编译不过，报 fmt::format_error 相关错误？ 先查格式串与实参是否匹配：数量、类型、进制/精度符号是否合法。字面量格式串的问题在编译期就暴露，运行时抛 fmt::format_error 的多是 fmt::runtime 包装的动态串。

中文/Unicode 输出乱码？ {fmt} 提供可移植的 Unicode 支持（README 列为特性之一），配合支持 UTF-8 的终端即可；对齐宽度按字符计数，CJK 宽字符在终端里占两列，肉眼对齐偏差多半来自这里，而不是库的问题。

该用 std::format 还是 {fmt}？ 工具链已支持 C++20/23 且只需基础格式化，标准库即可；需要颜色、chrono/ranges 扩展、老编译器支持或编译期格式串编译（FMT_COMPILE）时选 {fmt}。

担心编译变慢？ 上面的对比表显示 {fmt} 编译时间与 printf 相当（4.2s vs 1.2s），远快于 iostreams（21.8s）与 Boost Format（43.4s），二进制约束同样接近 printf。

延伸

• 完整 API 与格式语法：fmt.dev
• Compiler Explorer 在线试跑：README 内置链接，无需安装
• 性能方法学：format-benchmark、dtoa-benchmark
• 学习路径：先跑通"验证步骤"一节的示例，再对照格式规格表试写自己的格式串；需要接入项目时看 CMake 集成一节。

仓库地址：fmtlib/fmt