必须为自定义类型全特化std::formatter，否则std::format调用编译失败；需在std命名空间内定义parse()解析说明符、format()写入ctx.out()，并确保声明可见、const限定合规、字符类型明确。
std::format 要求自定义类型必须可格式化（即满足 formatter 特化）
直接对未特化的结构体调用 std::format 会编译失败，典型错误是：no matching function for call to 'format' 或更具体的 formatter<t> is not specialized</t>。C++20 的 std::format 不像 operator<< 那样自动回退到流输出，它严格依赖 std::formatter 特化。
关键点：你得自己为结构体提供 std::formatter 的全特化，并实现 parse() 和 format() 成员函数。
- 必须在命名空间
std内特化（且不能在函数体内或匿名命名空间） -
parse()负责解析格式说明符（如"{:x}"中的x），返回迭代器位置；若无需支持自定义说明符，可只处理空字符串 -
format()接收值和格式上下文，写入内容到ctx.out() - 确保该特化声明在所有使用
std::format的代码之前可见（通常放头文件或内联定义）
最简可行的 formatter 特化示例（仅支持默认格式）
假设结构体 Point：
struct Point {
int x, y;
};
为其添加 formatter：
立即学习“C++免费学习笔记（深入）”；
namespace std {
template<>
struct formatter<Point> : formatter<string_view> {
template <typename FormatContext>
auto format(const Point& p, FormatContext& ctx) const {
return format_to(ctx.out(), "({},{})", p.x, p.y);
}
};}
之后即可安全使用：
auto s = std::format("pos: {}", Point{3, 4}); // → "pos: (3,4)"
注意：formatter<Point> 继承自 formatter<string_view> 是常见捷径，这样可复用其 parse() 实现（支持空格式串），避免手动写 parse 逻辑。
支持自定义格式说明符（如 "{:hex}"）需手动解析
如果想让 std::format("{:hex}", my_struct) 生效，parse() 必须识别并存储说明符，format() 根据其分支处理。
- 说明符字符串由
std::format传入parse()，类型为format_parse_context::iterator - 推荐用
std::string_view提取子串后比对，例如检查是否以"hex"开头 - 把解析结果存为 struct 成员（如
bool hex_mode = false;），供format()使用 - 务必返回解析结束位置，否则后续格式化可能出错
示例片段（接上）：
namespace std {
template<>
struct formatter<Point> {
bool hex_mode = false;
constexpr auto parse(format_parse_context& ctx) {
auto it = ctx.begin(), end = ctx.end();
if (it != end && *it == 'h' && std::string_view(it, end).substr(0, 3) == "hex") {
hex_mode = true;
it += 3; // consume "hex"
}
return it;
}
template <typename FormatContext>
auto format(const Point& p, FormatContext& ctx) const {
if (hex_mode) {
return format_to(ctx.out(), "(0x{:x},0x{:x})", p.x, p.y);
} else {
return format_to(ctx.out(), "({},{})", p.x, p.y);
}
}
};}
常见坑：ADL 查找失败、头文件顺序、const 限定符
最容易卡住的地方不是语法，而是链接/可见性问题：
-
formatter特化必须定义在std命名空间，且不能在类定义内部或函数作用域里 —— 否则编译器找不到 - 包含
<format>头文件必须在特化声明之前（否则std::formatter模板未声明） - 如果你的结构体有
const成员或format()接收的是const T&，确保所有访问都是 const 正确的（比如get_x()也得是 const 成员函数） - 别试图用
using别名绕过特化（如using MyPoint = Point;），std::formatter<MyPoint>不会自动继承std::formatter<Point>
调试时可先尝试 std::format("{}", 42) 确认环境支持 C++20 格式库，再逐步加入自定义类型——很多问题其实出在编译器版本（GCC 13+/Clang 15+）或标准库实现差异上。
