c++oding="utf-8" ?>
不特化std::formatter，std::format对自定义智能指针或含私有/嵌套成员的复合对象必然编译失败；关键在于parse必须严格返回合法迭代器位置、format禁用递归调用std::format、特化须在std命名空间内全特化并显式指定char参数，且头文件需被所有使用点包含。
不特化 std::formatter，std::format 对任何自定义智能指针或含私有/嵌套成员的复合对象都必然编译失败；真正能跑通的关键不是“写对了 format”，而是 parse 返回位置严格、format 禁用递归调用 std::format、特化位置和可见性完全匹配编译器查找规则。
std::shared_ptr 特化必须在 std 命名空间内且显式带 char 参数
很多人在全局命名空间里写 template struct formatter<:shared_ptr>> { ... }</:shared_ptr>，结果编译器静默忽略——std::format 只查 std::formatter<t char></t> 的全特化，且必须在 namespace std { } 里。漏掉 char 或写成偏特化（比如 template<typename t> struct formatter<:shared_ptr>></:shared_ptr></typename>）都会触发 no matching function 错误。
- 正确写法必须是：
namespace std { template struct formatter<:shared_ptr>, char> { ... };</:shared_ptr> - 不能把特化放在
MyStruct定义所在的头文件末尾就完事——如果shared_ptr<mystruct></mystruct>在其他模块中被格式化，该头文件必须被包含，否则特化不可见 - MSVC 19.32+、GCC 13.3+、Clang 15.0+ 才稳定支持；GCC 13.2 之前需加
-D_GLIBCXX_USE_CXX11_ABI=1避免 libstdc++ 实验实现干扰
parse() 返回非法字符位置，不是 ctx.end() 就是崩溃源头
parse() 不是“跳过不识别的说明符”，而是“守界裁判”：它返回的位置告诉 std::format “从哪开始算非法”。返回 ctx.end() 表示“全部合法”，但若用户写了 {:deref8}，而你的 parse 只认 :deref 却返回 ctx.end()，后续 format() 会读到后面的 8 并可能越界。
- 常见错误写法：
return ctx.end();无条件返回，不管输入是什么 - 正确做法：逐字符校验，遇到不支持的立即返回当前迭代器（如
return it;） - 判断数字要用
std::isdigit(*it)，别手写*it >= '0' && *it （宽字符下失效） - 未识别的说明符应抛
std::format_error("unknown specifier")，不能静默忽略
format() 里递归格式化字段必须用 format_to，禁用 std::format
在 format() 成员函数里调用 std::format("{}", field) 是高危操作：每个 std::format 又触发自身 std::formatter 查找，最终导致无限模板实例化、编译卡死或栈溢出。
- 唯一安全路径是
std::format_to(ctx.out(), "{}", field)，它把结果直接写入已有输出迭代器，不新建上下文 - 若字段是私有成员，
format()访问不到：要么加friend struct std::formatter<mystruct char>;</mystruct>，要么提供公有访问接口（如as_tuple()或x()/y()成员函数） - 结构化绑定可在
format()内部安全使用（如auto [x, y] = p;），但它不解决特化缺失问题——必须先让原始类型可格式化
裸指针和智能指针不能混用同一套特化
std::format 默认不支持裸指针（int*）和智能指针（std::unique_ptr<t></t>），但二者处理逻辑完全不同：裸指针需复用 std::formatter<void char></void> 并做 static_cast<void></void>，而智能指针必须单独特化并显式处理 nullptr。
- 裸指针特化必须继承
std::formatter<void char></void>，不能直接特化std::formatter<int></int>（违反 ODR） - 智能指针特化中，
if (!ptr) return format_to(ctx.out(), "nullptr");是必须的，否则解引用空指针触发未定义行为 - 所有指针相关特化必须用
char（非char8_t）作为第二模板参数，除非你明确启用 C++20 字面量字符串字节类型支持
最常被忽略的不是语法细节，而是可见性与时机：特化必须在所有调用点之前被完整定义在头文件中，且不能依赖 ADL 或隐式查找——它是一份编译期契约，签错位置、签晚了、或者签得不全，std::format 就当它不存在。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
