fmt
设计一个 fmt 学习实验室：字节、所有权与编译期诊断
用小型教学工具展示格式契约和缓冲区限制，给出明确预期结果，同时不把交互演示或官方路线图写成已经交付。
你将学会
- 让隐藏契约可以看见
- 用时间线教授所有权
- 只加入真正帮助理解的交互
开始前需要
- 理解基础 C++ 值、引用、字符串与构建目标
- 能够区分文档预期与实际测量结果
追踪具体 fmt 行为，在输出、生命周期和验证边界明确的前提下选择集成方式。
先看结论
- 把逻辑长度、实际字节和所有权作为不同事实展示。
- 预期编译拒绝需要合法基线和明确诊断。
- 学习工具是提案，不是已经上线的交互产品或官方计划。
让隐藏契约可以看见
有价值的学习项目可以并排展示格式字符串、类型化参数和最终字节。有界输出面板则分别列出逻辑结果、实际前缀、返回迭代器和总长度。相比一张运行成功的终端截图，这种方式更能具体解释 format_to_n 的契约。
案例应保持小而确定：一个超过三字符目标的整数、零写入限制，以及一个三字节 UTF-8 字符。对不完整序列要显式标记，不能悄悄画成合法文字。当前文章的静态图用于说明这些案例，所描述的交互浏览器仍是后续扩展设想。
用时间线教授所有权
第二个面板可以展示参数插入动态存储、底层数组被修改，以及稍后格式化的过程。通过可见的生命周期区间，把副本、引用包装器和字符串视图区分开。先让读者预测哪些结果会变化，再展示有界原生夹具实际产生的结果。
编译期诊断需要另一种呈现方式：把合法源文件和一个故意非法的字面量配对，确认编译器是否因预期原因拒绝后者。缺少头文件导致的构建失败不能证明格式检查有效。每个结果都应保存工具链身份和诊断类别，才能让学习过程可复现。
只加入真正帮助理解的交互
二维 SVG 字节格和所有权时间线已经足以表达这些关系。旋转的 Three.js 场景会增加渲染与无障碍工作，却未必把契约讲得更清楚。若实现交互版本，应提供键盘操作、文字等价说明和静态回退，不要让理解概念依赖动画。
这是独立的教育项目建议，不是 fmt 官方路线图。真正完成它，还需要实现控件、隔离可能存在的编译服务，并测试实际界面。发布设计文章和静态 SVG，不意味着已经交付托管编译器、交互练习场或生产性能面板。
实施步骤
- 1
从有界 C++ 案例和明确预期结果开始。
- 2
绘制字节格和借用数据生命周期区间。
- 3
先验证合法构建，再检查预期失败的编译。
- 4
把无障碍交互控件的实现与测试作为单独扩展。
可复制示例
{"proposedPanels":["output byte cells","argument ownership timeline","compiler diagnostic comparison"],"interactiveExplorerShipped":false,"officialRoadmap":false,"hostedCompilationService":false,"comparativeBenchmark":null}常见问题
这些页面包含可以操作的 fmt 练习场吗？
目前没有。系列提供静态项目专属图和有界示例，交互浏览器是学习项目提案。
为什么不直接用 Three.js 绘图？
这里的核心关系是字节位置和生命周期，清楚的二维图就能直接表达，无需增加无关空间维度。
资料来源
- doc/syntax.md来源核查 2026-09-08
- include/fmt/core.h来源核查 2026-09-08
- include/fmt/args.h来源核查 2026-09-08
- test/format-test.cc来源核查 2026-09-08
- test/args-test.cc来源核查 2026-09-08