c++oding="utf-8" ?>
必须特化 std::formatter，否则 std::format 无法识别自定义类型，编译报错；特化需在 std 命名空间内全特化 struct，签名严格匹配标准，parse() constexpr 返回 decltype(ctx.begin())，format() 为 const 成员函数，且特化声明须与类定义同头文件并前置可见。
直接给结论：不特化 std::formatter，std::format 就不认识你的类，编译必报错——典型错误是 formatter not specialized for 'MyClass' 或 no matching function for call to 'format'。这不是配置问题，是 C++20 标准强制要求的契约。
必须在 std 命名空间内做全特化
特化不是写个辅助函数就行，它必须是 template struct std::formatter<myclass char></myclass> 这种形式，且必须出现在 std 命名空间里。常见错误包括：
- 在全局或自定义命名空间里定义，链接时找不到特化，或重载决议失败
- 写成偏特化（比如
template<typename t> struct std::formatter<mytemplate>, char></mytemplate></typename>），标准禁止这种写法 - 头文件没包含特化定义，而只在 .cpp 里实现——模板特化必须在所有使用点可见
parse() 和 format() 的签名与 const 约束不能错
这两个函数的原型、返回类型、参数顺序、const 限定都必须严格匹配标准要求，否则 std::format 无法识别该特化：
-
parse()必须是constexpr，返回类型得是decltype(ctx.begin())（不能手写auto后被推导成别的类型） -
format()必须是const成员函数，参数为const MyClass&和FormatContext&，返回FormatContext::iterator - 漏掉
const会导致formatter does not satisfy formatter编译错误 - 不要在
format()里调用std::format递归格式化字段——容易触发无限模板实例化；改用std::format_to(ctx.out(), ...)
支持格式说明符（如 {:x}、{:8}）要自己解析
std::format 不提供现成的说明符解析器，parse() 得手动处理字符串迭代器：
-
ctx.begin()指向{:...}中冒号后的第一个字符，比如{:04x}里指向'0' - 需逐字符判断：是否为
'x'（启用十六进制）、是否为数字（提取宽度）、是否为空格（跳过） - 未识别的字符不能忽略——必须停在非法位置，否则运行时报
std::format_error - 解析出的参数（如
width_、hex_）建议存为成员变量，供format()使用；别在format()里重新解析
私有成员访问和字符类型兼容性
如果你的类字段是私有的，format() 无法直接读取：
- 加
friend struct std::formatter<myclass char>;</myclass>是最干净的解法 - 或提供公有
to_string()/as_tuple()辅助接口，避免暴露过多实现细节 - 注意
char_type：默认用char，但若需宽字符支持，得同时特化std::formatter<myclass wchar_t></myclass>，且确保std::char_traits<wchar_t></wchar_t>可用 - GCC 12 默认仍用实验性 libstdc++ 实现，
std::format支持不完整；Clang 15+ / GCC 13+ / MSVC 19.32+ 才推荐用于生产
最容易被忽略的其实是可见性——特化声明必须和类定义在同一头文件中，且在所有 #include 它的地方之前完成定义。不是“写了就能用”，而是“写对位置、写对签名、写对可见范围”三者缺一不可。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
