std::format不支持嵌套容器自动递归格式化，必须为每种类型全特化std::formatter；偏特化被禁止，特化需带char模板参数且置于头文件；应使用std::format_to避免无限模板实例化，并正确实现parse()守门逻辑。
std::format 本身不支持嵌套容器或结构体的自动递归格式化，必须手动为每种具体类型全特化 std::formatter，否则编译直接失败——这不是配置问题，也不是头文件漏包含，而是标准库设计如此。
为什么 std::format("{}", vec2d) 会编译报错？
因为 std::vector<:vector>></:vector> 是一个新类型，std::formatter 不会自动递归推导内层类型。即使外层 std::vector 有默认特化，std::vector<:vector>></:vector> 仍需你显式定义全特化。
- 错误写法：
template<typename t> struct std::formatter<:vector>, char></:vector></typename>—— 这是偏特化，C++ 标准禁止，编译器报错“partial specialization not allowed” - 正确写法：
template struct std::formatter<:vector>>, char></:vector>—— 必须带char模板参数，且不能省略任何层级 - 常见误判：把特化写在 .cpp 文件里 → 其他翻译单元看不到，调用点仍报
no matching function for call to 'format'
如何安全实现 format() 而不卡死编译？
核心原则：禁用嵌套 std::format，只用 std::format_to 向当前输出迭代器写入。否则可能触发无限模板实例化，导致编译内存爆满或超时。
- 危险操作：
auto s = std::format("{}", inner);—— 新建格式上下文，重新走一遍所有std::formatter查找 - 安全操作：
std::format_to(ctx.out(), "[{}]", inner)—— 复用当前ctx.out()，不触发二次查找 - 叶节点（如
int、std::string）也必须用std::format_to(ctx.out(), "{}", value)，才能保留精度、填充等格式能力 - 若
inner是自定义类型（如Point），确保它已有std::formatter<point char></point>特化，否则这里会立刻编译失败
parse() 函数为什么不能无脑返回 ctx.end()？
parse() 不是“跳过检查”，而是格式字符串的守门人。返回 ctx.end() 表示“我接受全部输入”，但若用户传了非法格式符（如 {:x@}），std::format 就不会报错，后续行为不可控。
- 最小合规写法：
return ctx.begin();—— 表示只接受空格式说明符（即{}）；遇到{:x}就停在'x'处并抛std::format_error - 若要支持
{:indent=2}，必须手动解析=后内容，用std::from_chars转数字，不能只取第一个字符 - 别写
*it >= '0' && *it —— 宽字符下失效；改用 <code>std::isdigit(static_cast<unsigned char>(*it))</unsigned>
struct 里含嵌套容器怎么办？
比如 struct Config { std::map<:string std::vector>> data; };</:string>，这需要三层协同：你得同时提供 std::formatter<config char></config>、std::formatter<:map>, char></:map>、std::formatter<:vector>, char></:vector>，缺一不可。
- 在
Config的format()里可用结构化绑定：auto const& [data] = c;，再调用std::format_to(ctx.out(), "data={}", data) - 但前提是
std::map<...></...>类型已特化；否则这里就卡住 - 所有特化必须放在同一头文件中，并包裹在
namespace std { }内；不能分散在多个文件里 - 如果字段是 private，要么加
friend struct std::formatter<config char>;</config>，要么提供as_tuple()接口供std::apply使用
最易被忽略的点：所有特化代码必须定义在头文件中，且每个调用 std::format 的源文件都得包含该头文件——不是“写一次全局生效”，而是每个 TU 都要看到完整定义。漏掉任意一层特化，或放错位置，编译失败时错误信息往往指向 std::format 调用点，而不是真正缺失的特化声明。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
