std::format要求对自定义智能指针和含私有/嵌套成员的复合对象显式全特化std::formatter，且必须在namespace std{}内定义；空值需手动检查，parse()须精准返回非法字符位置。
std::format 对自定义智能指针和含私有/嵌套成员的复合对象默认完全不支持，直接调用会编译失败——这不是配置遗漏，而是标准强制要求你显式提供 std::formatter 全特化。
智能指针必须单独特化，不能复用 void* 特化
裸指针能靠继承 std::formatter<void char></void> 解决，但 std::shared_ptr<t></t> 或 std::unique_ptr<t></t> 是独立类型，复用 void* 特化会导致编译器静默忽略或链接失败。关键点：
- 必须在
namespace std { }内写全特化，例如template struct formatter<:shared_ptr>, char></:shared_ptr> - 不能写成偏特化（如
template<typename t> struct formatter<:shared_ptr>, char></:shared_ptr></typename>），标准禁止 -
format()中必须显式检查空值：if (!ptr) return format_to(ctx.out(), "nullptr");，否则解引用nullptr是未定义行为 - 若要格式化所指对象（如
SP[{x},{y}]），直接传*ptr给std::format_to即可——前提是MyStruct本身已特化过std::formatter
复合对象的 formatter 必须在 std 命名空间内且头文件可见
很多人把 std::formatter 特化写在 .cpp 文件里，或放在类定义之后但没确保所有使用点都包含该头文件，结果编译报 formatter not specialized for 'MyClass'。真正生效的前提是：
- 特化定义必须位于
namespace std { }中，不能在全局或自定义命名空间 - 必须是全特化：
template struct std::formatter<myclass char></myclass>，漏掉template或写错模板参数个数都不行 - 特化声明需与
MyClass定义同在一个头文件，或被所有调用std::format的源文件包含 - 若
MyClass有私有成员，format()无法直接访问——加friend struct std::formatter<myclass char>;</myclass>是最轻量解法
parse() 返回位置错误是运行时崩溃的隐形源头
parse() 不是“解析完就返回 ctx.end()”，它返回的是第一个非法字符的位置。返回错会导致 std::format 在 format() 阶段读越界或触发未定义行为。典型陷阱：
- 用户写了
{:x8}，而你的parse()只认x，却返回ctx.end()→ 后续format()会看到后面的8并可能误用 - 正确做法是逐字符判断：
if (*it == 'x') { ++it; return it; }，遇到不支持的字符立即返回it - 数字解析必须用
std::isdigit(*it)，别手写*it >= '0' && *it ——宽字符下失效 - 不支持的说明符应抛
std::format_error("unknown specifier")，不能静默跳过
format() 里禁止递归调用 std::format
在 format() 函数中写 std::format("{}", field) 看似自然，实则危险：每次调用都会触发新的 std::formatter 查找，形成无限模板实例化，轻则编译卡死，重则 OOM。唯一安全路径是：
- 用
std::format_to(ctx.out(), "{}", field)，它把结果直接写入已有输出迭代器，不新建上下文 - 嵌套字段可直接复用已特化的
std::formatter，无需额外逻辑 - 若字段类型尚未特化，先补上对应
std::formatter，而不是绕开 - 所有输出必须走
ctx.out()，不能用std::cout或拼接std::string
最容易被忽略的是 parse() 的边界语义和特化声明的可见性——它们不出现在错误信息里，但只要错一点，整个特化就形同虚设。编译器不会提醒你“这个特化没被找到”，只会报“no matching function”。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
