std::format 不认自定义 struct 是因标准强制要求必须特化 std::formatter；它不依赖 ADL 或 operator<<，仅通过显式全特化 std::formatter<T> 提供 parse() 和 format() 成员函数才能工作。
直接在 std::format 里传自定义结构体，不特化 std::formatter 就会编译失败——这不是配置问题，是标准强制要求。
为什么 std::format 不认你的 struct？
因为 std::format 完全不依赖 ADL 或 operator，它只查 <code>std::formatter<t char></t> 的全特化。没这个特化，连模板实例化都过不去，报错通常是：
error: no matching function for call to 'format'formatter not specialized for 'MyStruct'-
formatter does not satisfy formatter（常因漏const或返回类型不对）
特化必须写在 std 命名空间里，且是全特化（不能带 template<typename>），否则链接或重载决议失败。
最简能跑通的 formatter 特化长什么样？
以 struct Vec2 { float x, y; }; 为例，最小可用特化只需三样东西：
立即学习“C++免费学习笔记（深入）”；
-
parse()：哪怕只写return ctx.end();，也不能删 -
format()：参数必须是const Vec2&，函数声明末尾加const -
char_type：显式声明using char_type = char;（constexpr static char_type也行，但前者更稳）
示例：
struct Vec2 { float x, y; };
<p>template<>
struct std::formatter<Vec2, char> {
using char_type = char;</p><pre class='brush:php;toolbar:false;'>constexpr auto parse(std::format_parse_context& ctx) {
return ctx.end();
}
template <typename FormatContext>
auto format(const Vec2& v, FormatContext& ctx) const {
return std::format_to(ctx.out(), "({:.2f},{:.2f})", v.x, v.y);
}};
注意：format_to 写进 ctx.out()，不是 std::cout；parse 返回类型用 auto 在 Clang/GCC 上可能推导失败，建议显式写 decltype(ctx.begin())。
支持 "{:x}" 这类格式说明符要手动解析
std::format 不提供现成的解析器，所有格式字符都得自己啃。比如想支持 {:hex} 或 {:4}，就得在 parse() 里逐字符判断：
- 用
it = ctx.begin()开始遍历，*it是当前字符 - 识别到非法字符必须立刻停住并返回该位置（不能跳过），否则触发
std::format_error - 把结果存成成员变量（如
bool hex_ = false;、int width_ = 0;），format()里直接用 - 不要在
format()里重新解析字符串——性能差，还容易出错
例如支持 {:X}（大写十六进制）和宽度：
template<>
struct std::formatter<MyInt, char> {
bool upper_ = false;
int width_ = 0;
<pre class='brush:php;toolbar:false;'>constexpr auto parse(std::format_parse_context& ctx) -> decltype(ctx.begin()) {
auto it = ctx.begin();
auto end = ctx.end();
if (it != end) {
if (*it == 'X') { upper_ = true; ++it; }
else if (std::isdigit(*it)) { width_ = *it - '0'; ++it; }
}
return it; // 必须返回解析结束点
}
template <typename FormatContext>
auto format(const MyInt& n, FormatContext& ctx) const {
if (width_ > 0) {
if (upper_) {
return std::format_to(ctx.out(), "{:0{}X}", n.val, width_);
}
return std::format_to(ctx.out(), "{:0{}d}", n.val, width_);
}
return std::format_to(ctx.out(), "{}", n.val);
}};
容易被忽略的头文件与可见性问题
特化必须在所有调用 std::format(..., your_struct) 的地方之前被看到。常见坑：
- 把特化写在
.cpp文件里 → 其他 TU 编译不过 - 特化放在结构体定义之后，但头文件没包含它 → 链接时报 undefined reference
- 用了
std::string_view或std::format_to却忘了#include <format>和#include <string> - 在 GCC 12 上测试 → 默认 libstdc++ 没完整实现
std::format，需升级到 GCC 13+ 或加-D_GLIBCXX_USE_CXX11_ABI=1
最稳妥做法：把特化和结构体定义放同一个头文件，且确保该头文件在任何使用 std::format 的地方都被 #include。
