C++20 std::format:像 Python 一样格式化字符串

字数约 2500 | 阅读约 3 分钟 | C++20

引子：告别 printf 的噩梦

⚠️ 你大概率见过这种代码：

printf("%s 今年 %d 岁，GPA: %.2f\n", name, age, gpa);

格式字符串里 %s、%d、%.2f 混在一起。写多了之后，你一定会怀疑人生——

• 参数顺序搞反了？编译期不报错，运行时直接 UB（未定义行为，程序可能崩溃或输出乱码）。
• 想右对齐一段文本？printf 你得算空格数，手动补。
• 想给数字补零？%08d——记住这个写法也得花点脑子。

💡 C++ 的标准库开发者也受够了。于是 C++20 引入了 std::format，一个更安全、更灵活、更像 Python f-string 的字符串格式化方案。

一句话概念

⚡ std::format 就是一个返回 std::string 的格式化函数。

用生活来打比方：printf 像是直接往墙上喷油漆——喷出去就收不回来了。而 std::format 像是先把油漆涂在画布上，你满意了再上墙，不满意直接扔了重来。

它的核心优势：返回 string，不直接打印。这意味着你可以把格式化结果存起来、拼接起来、传给任何需要字符串的地方。

基础用法

先来看最简用法，对比之前学过的 std::print：

#include <iostream>
#include <string>
#include <format>

// C++20
int main() {
    std::string name = "小明";
    int age = 25;

    // std::print: 格式化后直接输出到终端
    std::print("{} 今年 {} 岁\n", name, age);

    // std::format: 格式化后返回 string，不打印
    std::string msg = std::format("{} 今年 {} 岁", name, age);
    std::print("{}\n", msg);
}

输出：

小明 今年 25 岁
小明 今年 25 岁

注意两个细节：

• 花括号 {} 就是占位符，按顺序填入参数。和 std::print、Python f-string 一样的语法。
• std::print 是格式化+输出一步到位，std::format 只负责格式化，返回的 string 你可以随便折腾。

格式说明符：花括号里的学问

通用格式

花括号里还能塞东西，这些就叫格式说明符（Format Specifier）。

格式说明符遵循一个通用模板：

{[序号]:[填充][对齐][宽度][.精度][类型]}

从左到右，每个部分都是可选的：

合成起来就是：{:填充字符+对齐+宽度+精度+类型}，冒号后面写格式部分。

举几个从简单到完整的例子：

// 最简：顺序占位
std::format("{} 岁", 25);        // "25 岁"

// 加宽度 + 右对齐
std::format("{:>8}", 42);        // "      42"

// 宽度 + 对齐 + 填充字符
std::format("{:*^10}", "Hi");    // "****Hi****"

// 宽度 + 精度 + 类型
std::format("{:>8.2f}", 3.14);   // "    3.14"

// 补零（0 作为填充字符 + 宽度 + 类型）
std::format("{:08d}", 42);       // "00000042"

下面逐个拆解这些字段。

对齐：{:>10}、{:<10}

#include <iostream>
#include <format>

// C++20
int main() {
    std::print("名字:{:<10} 年龄:{:>3}\n", "小明", 25);
    std::print("名字:{:<10} 年龄:{:>3}\n", "小红", 18);
}

输出：

名字:小明      年龄: 25
名字:小红      年龄: 18

• {:<10}：左对齐，总宽度 10 字符，不够用空格补。
• {:>10}：右对齐，同理。
• 宽度数字决定最少占几位，实际内容更长时会自动扩宽，不会截断。

精度：{:.2f}

#include <iostream>
#include <format>

// C++20
int main() {
    double price = 19.9;
    std::print("商品价格: {:.2f} 元\n", price);

    double pi = 3.14159265;
    std::print("圆周率: {:.4f}\n", pi);
}

输出：

商品价格: 19.90 元
圆周率: 3.1416

• {:.2f}：保留两位小数，四舍五入。和 printf 的 %.2f 完全一致，但语法更统一。

补零：{:08d}

#include <iostream>
#include <format>

// C++20
int main() {
    int day = 7;
    std::print("今天是第 {:02d} 天\n", day);

    int code = 42;
    std::print("验证码: {:08d}\n", code);
}

输出：

今天是第 07 天
验证码: 00000042

• {:08d}：总共 8 位，不足前面补零。0 是填充字符，8 是宽度，d 是类型。

指定位置：{0}、{1}

花括号里还能写数字，指定用哪个参数：

#include <iostream>
#include <format>

// C++20
int main() {
    std::string name = "Alice";
    int age = 30;

    // {0} 和 {1} 指定用第几个参数（从 0 开始），可以重复使用
    std::string s = std::format("{1} 比 {0} 大 {1} 岁", age, name);
    std::print("{}\n", s);
}

输出：

Alice 比 30 大 Alice 岁

等等，这个输出有点怪——"30 大 Alice 岁"？这说明 {0} 和 {1} 是按参数索引来取值的，{0} 取第一个参数 age（值为 30），{1} 取第二个参数 name（值为 "Alice"）。

⚠️ 这个示例其实故意展示了格式安全的好处：如果你用 printf 写错了参数类型，程序会静默输出乱码；而 std::format 如果格式字符串和参数不兼容，会直接抛出异常而不是输出乱码。

更实用的写法是这样的：

#include <iostream>
#include <format>

// C++20
int main() {
    std::print("{0} 说：{0} 今年 {1} 岁\n", "小明", 25);
}

输出：

小明 说：小明 今年 25 岁

💡 同一个参数可以多次引用，不用担心。

和 std::print 的关系

之前讲 std::print 的时候你可能疑惑过：这两个家伙到底什么区别？

⚡ 一句话：std::print 内部就是调用了 std::format 再输出到终端。

std::print("Hi {}", name)
    ↓
1. 先调用 std::format("Hi {}", name) → 得到 string "Hi Alice"
2. 再把 "Hi Alice" 输出到终端

所以 std::format 更底层、更灵活。你想把结果存起来？用 std::format。只想打印？用 std::print 更方便。

💡 类比：std::format 像是面包机（做好面包给你），std::print 像是面包机+传送带（做好面包直接递到你手上）。

实战：用 format 拼一个对齐表格

格式说明符真正的威力，在需要排版的时候才能发挥出来。

#include <iostream>
#include <format>
#include <string>
#include <vector>

// C++20
int main() {
    struct Student { std::string name; int age; double gpa; };
    std::vector<Student> students = {
        {"Alice",  25, 3.85},
        {"Bob",    18, 3.92},
        {"Carol",  22, 3.67},
        {"David",  20, 3.99},
    };

    // 用空字符串 + 宽度自动生成分隔线
    std::print("+{:-<10}+{:-<8}+{:-<8}+\n", "", "", "");
    std::print("| {:<10} | {:>6} | {:>6} |\n", "Name", "Age", "GPA");
    std::print("+{:-<10}+{:-<8}+{:-<8}+\n", "", "", "");

    for (const auto& s : students) {
        std::print("| {:<10} | {:>6} | {:>4.2f} |\n", s.name, s.age, s.gpa);
    }

    std::print("+{:-<10}+{:-<8}+{:-<8}+\n", "", "", "");
}

输出：

+----------+--------+--------+
| Name      |    Age |    GPA |
+----------+--------+--------+
| Alice     |     25 |  3.85 |
| Bob       |     18 |  3.92 |
| Carol     |     22 |  3.67 |
| David     |     20 |  3.99 |
+----------+--------+--------+

💡 几行代码，表格整齐划一。不需要手动算空格，不需要 cout << " " 一个个拼。格式说明符自己就把对齐和精度搞定了。

陷阱与注意事项

1. 编译器支持

⚠️ std::format 是 C++20 特性，但不是所有编译器都完整实现了它。

如果你的编译器版本偏旧，编译时会直接报错。解决方法：升级编译器，或者在编译时加上 -std=c++20（GCC/Clang）或 /std:c++20（MSVC）。GCC 11/12 用户若用 libstdc++ 扩展，可能需要链接 -lstdc++exp。

2. 格式字符串不合法 → 运行时抛出异常（好消息）

std::format 的格式字符串在运行时检查。如果你写了 {:x} 但传了一个不支持的类型（比如 string），程序会抛出 std::format_error 异常，而不是静默 UB。

💡 这比 printf 安全太多——printf 遇到 %s 传了 int，直接 UB 且毫无提示；std::format 至少会抛出明确的异常告诉你出错了。

3. 性能：format 比 printf 慢吗？

早期实现中 std::format 确实比 printf 慢一些。但近几年的编译器优化后，差距已经很小了。对于绝大多数应用场景，性能不是问题。如果你真的在意那一点差距，用 std::print（它直接输出，不产生中间 string）就好。

总结

下期预告

格式化字符串讲完了，但你有没有觉得：每写一段 C++ 代码都要手动写格式说明、再把数据填进去，挺啰嗦的？从下周开始，我们进入 C++11 单元特性系列——从最简单的"遍历容器"开始。C++11 给了一行代码就能遍历整个 vector 的语法，再也不用写又臭又长的迭代器循环了。敬请期待。

觉得有用？点个关注，我们一起把 C++ 学明白 👇

公众号：我爱C嘎嘎 · 每天一个 C++ 新特性。