std::formatter必须全特化且在std命名空间内声明，否则std::format编译期无法查找；偏特化被标准禁止，Clang/GCC 13+直接报错，MSVC可能静默忽略而回退到fallback。
std::formatter必须全特化且在 std 命名空间内
不写 namespace std { }，std::format 根本找不到你的特化——不是链接失败，是编译期就放弃查找。偏特化（比如 template）被标准明确禁止，Clang 和 GCC 13+ 会直接报错，MSVC 可能静默忽略导致调用 fallback（如 operator）或崩溃。
必须写成：
namespace std {
template struct formatter<point char> {
// ...
};}</point>
注意两个模板参数：类型名 Point 和字符类型 char（宽字符场景才换 wchar_t）。头文件中定义类后，立即在同一头文件末尾写这个特化，否则包含该头的源文件可能看不到它。
parse() 必须返回解析结束位置，不能硬写 ctx.end()
常见错误是不管输入直接 return ctx.end();。这会让 "{:x8}" 这种格式被当作合法（因为 ctx.end() 表示“全部吃掉”），但实际只支持 x，8 是非法残留。运行时 std::format 会检查未解析完的部分，抛 std::format_error。
正确做法是逐字符推进并返回当前位置：
- 用
auto it = ctx.begin();开始 - 识别
'x'后执行++it; - 遇到不支持的字符（如
'f'）立刻return it;（不是跳过） - 支持数字宽度时，用
std::isdigit(*it)判断，别手写*it >= '0'
漏掉 constexpr 修饰也会让编译失败，返回类型建议显式写 format_parse_context::iterator，避免 auto 在复杂模板上下文中推导出错。
format() 内部禁用 std::format，必须用 std::format_to
在 format() 函数里写 std::format("{}", p.x) 是高危操作：它会触发新一轮 std::formatter 查找，而该查找又可能再次进入你的 format()（如果误配了 ADL 或命名空间），最终导致无限模板实例化——编译卡死、内存爆满或报错 template instantiation depth exceeds maximum。
安全路径只有一条：std::format_to(ctx.out(), "{:04}", p.x)。
- 它把结果直接写入已有的输出迭代器，不新建上下文
- 对另一个也实现了
std::formatter的自定义字段（如p.name），同样用format_to，自动复用其特化逻辑 - 绝对不要拼接
std::string或调用std::to_string()——会丢失对齐、填充、精度控制，且无法嵌套格式说明符
自定义说明符（如 {:hex}）需手动存状态，不能 runtime 解析
想支持 "{:hex}" 或 "{:short}"，不能在 format() 里重新解析格式字符串。每次调用 format() 都要解析一遍，性能差，还容易和 parse() 逻辑不一致。
应该：
- 在
parse()中把结果存为成员变量，如bool hex_ = false;、int width_ = 0; - 用
if (it != ctx.end() && std::equal(it, it + 3, "hex"))或简单循环比对字符串 - 遇到非法组合（如
"{:hex:x}"）立即抛std::format_error("invalid specifier")，不要静默忽略 -
format()里只做分支判断：if (hex_) return format_to(...); else return format_to(...);
注意：所有成员变量必须是 const 成员函数可读的，所以声明在结构体内部即可，无需 mutable。
最易被忽略的是 parse() 返回值和 format() 中输出路径的耦合关系：返回位置错了，std::format 就不知道哪些字符已被消费；输出没走 ctx.out()，整个格式化链路（对齐、填充、宽度）就彻底失效——它不会帮你补，只会静默丢弃。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
