c++oding="utf-8" ?>
结论：不特化std::formatter，std::format对自定义类必编译失败；必须在std命名空间内全特化，含Point和char两模板参数，parse()须返回ctx.end()，format()须用ctx.out()输出。
直接给结论：不特化 std::formatter，std::format 对自定义类一定会编译失败，报错类似 no matching function for call to 'format' 或 formatter not specialized for 'MyClass'。这不是配置问题，是 C++20 标准强制要求——没有反射，必须手动提供格式化逻辑。
std::formatter 必须全特化且在 std 命名空间内
编译器只会在 std 命名空间里查找 std::formatter 的全特化版本。偏特化（比如 template）不被标准认可，多数编译器会静默忽略或报错。
- 特化声明必须写在
namespace std { ... }里，不能在外面用using或别名绕过 - 必须显式写出两个模板参数：
Point和char（除非你要支持宽字符，才换wchar_t） - 头文件中定义、声明必须一致；如果类定义在
point.h，那 formatter 特化也得放在同一头文件末尾，或确保所有包含point.h的源文件都能看到该特化 - MSVC 19.32+、GCC 13+、Clang 15+ 才稳定支持；GCC 12 默认仍用旧版 libstdc++ 实验实现，可能连
std::format都不启用，需加-std=c++20 -D_GLIBCXX_USE_CXX11_ABI=1
parse() 函数不是可选的，哪怕什么都不做也得写
parse() 负责检查你传进来的格式说明符（比如 "{:x}" 中的 x），哪怕你的类型完全不支持任何修饰符，也必须返回一个合法迭代器位置，否则链接期或运行期行为未定义。
- 最简安全写法是
return ctx.end();，表示“没解析到任何有效说明符，全部跳过” - 不要写
return ctx.begin();—— 这会让格式化器误以为说明符还没结束，后续format()可能读到非法状态 - 如果要支持自定义说明符（如
"{:short}"），就得手动遍历ctx.begin()到ctx.end()，遇到'}'停止，并抛std::format_error处理非法输入 - 返回类型必须严格是
decltype(ctx.begin())，用auto推导通常没问题，但若上下文类型复杂（比如嵌套模板），显式写std::format_parse_context::iterator更稳
format() 内部必须用 ctx.out()，不能用 std::cout 或 string +=
format() 的职责是把字符“写入输出迭代器”，不是打印到屏幕或拼接字符串。它接收的是 FormatContext&，其 ctx.out() 返回一个输出迭代器（类似 std::back_insert_iterator），所有内容必须通过它写入。
- 正确写法：
return std::format_to(ctx.out(), "({},{})", p.x, p.y); - 错误写法：
std::cout —— 输出目标错，且返回值类型不匹配 - 若类有私有成员（如
int x_, y_;），format()无法直接访问，要么加friend struct std::formatter，要么提供公有; int x() const访问器 - 注意
std::format_to返回值类型和format()要求的返回类型一致（都是输出迭代器），所以可以直接return它的结果
最容易被忽略的其实是可见性：特化必须在每个使用 std::format(..., my_obj) 的翻译单元里都可见。把它塞在 .cpp 里？不行。放在类定义前？也不行——因为 std::formatter 模板参数依赖 Point 的完整定义。唯一稳妥的做法是：类定义、formatter 特化、#include 全部收在一个头文件里，并确保用户只 include 这一个头。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
