std::format不是printf平替，而是编译期强校验、类型安全但环境门槛更高的新机制；需包含<format>头文件，GCC≥13/Clang≥15/MSVC≥19.34/Xcode≥14.3，格式串必须为字面量，占位符与参数数量须严格匹配。
std::format 不是 printf 的平替，它是编译期强校验、类型安全、但环境门槛更高的新机制——用不了不是你写错了，大概率是编译器、标准库或编译选项没对齐。
std::format 编译失败：未声明的标识符
这是最常见也最容易误判的问题。错误信息通常是 error: 'format' is not a member of 'std' 或 undefined reference to std::vformat。
- 必须显式包含
#include <format>，它不在<iostream>或<string>里 - GCC 需 13+ 且链接新版 libstdc++（
-lstdc+++ libstdc++ ≥ 13），仅-std=c++20不够 - Clang 需 15+；MSVC 需 19.34+（VS 2022 17.4+），旧版即使开了
/std:c++20也只声明不实现 - macOS Xcode 14.3 起才带基础支持，locale 相关重载需额外宏（如
-D_LIBCPP_ENABLE_CXX20_FORMAT）
格式字符串不能是 std::string 变量
std::format 要求格式串必须是字面量（const char[]）或 consteval 表达式，运行时拼接直接编译报错。
- ✅ 正确：
std::format("Value: {}", 42)、std::format(R"({"id": {}})", id) - ❌ 错误：
std::string fmt = "Value: {}"; std::format(fmt, 42);→error: format string argument must be a string literal - 若真需动态格式串，别硬扛——改用 {fmt} 库（API 兼容，支持
fmt::format(fmt_str, args...)）
占位符数量与参数不匹配会抛 std::format_error
这不是编译错误，而是运行时异常，容易在测试覆盖不到的分支里暴露。
立即学习“C++免费学习笔记（深入）”；
- {} 数量 > 参数个数 → 抛
std::format_error（例如std::format("{}, {}, {}", 1)） - {} 数量 std::format("{}", 1, 2, 3) 只用第一个）
- 混用索引和自动编号非法：
"{0} {}"编译失败，必须统一为"{0} {1}"或"{} {}" - 转义花括号必须用双大括号：
"{{}}" → "{}"，"{{{}" → "{{"，"name {{age: {}}}" → "name {age: 25}"
宽字符、locale、自定义类型支持需额外条件
这些功能看似标准，实则依赖编译器实现进度和宏开关，不是“开了 C++20 就自动有”。
- 宽字符：没有
std::wformat，但可传std::wstring_view字面量（L"{}"是const wchar_t[3]，需确保编码一致） - locale 支持：GCC/Clang 需定义对应宏（如
-D_GLIBCXX_USE_CXX11_ABI=1），MSVC 需 STL ≥ 17.4 且启用实验性开关 - 自定义类型：必须特化
std::formatter<T>模板，并满足formattable要求（否则编译失败，提示 no matching function for call to 'format'）
真正卡住人的从来不是语法，而是 GCC 12 下死活不链接、Clang 14 里 locale 重载不可见、或者把 std::string fmt 当成合法输入——这些边界条件不试到就永远不知道缺哪一环。
