普通YAML别名可以复用一个节点,但如果这个节点里的引用又指回自身,数据就不再只是一棵向下展开的树。把这种结构交给只输出普通JSON的转换入口,可能在序列化阶段失败,并非把缩进对齐就能解决。

2026年11月20日,在YAML与JSON转换工具输入一个最小公开样例:node设置锚点,内部self使用同一个别名。本次页面提示Converting circular structure to JSON,并指出self形成循环,右侧没有生成本次JSON结果。

当前工具在自引用样例中报告循环结构,未生成可交付的JSON输出
当前工具在自引用样例中报告循环结构,未生成可交付的JSON输出

YAML引用关系不等于JSON展开副本

YAML的表示模型可以包含对同一节点的引用,甚至形成循环;JSON本身没有直接表达这种对象身份和循环指针的语法。普通别名展开一次看起来像复制对象,并不能推出自引用也可以无穷展开为有效JSON。

本机另外创建一个self指向自身的JavaScript对象。引用相等检查为true,JSON.stringify抛出TypeError。这是独立的对象模型对照,不是重新实现工具的YAML加载过程,更不是页面提供了可勾选的循环处理模式。

工具错误与本机循环对象序列化对照分开记录;显式id方案属于另行约定的数据结构
工具错误与本机循环对象序列化对照分开记录;显式id方案属于另行约定的数据结构

需要引用时明确设计交换格式

如果接收方需要普通JSON,可以在双方约定后用id与self_ref等字段表达引用。本次显式字符串引用样例能够转成JSON,但这些名字只是演示,JSON解析器不会自动把self_ref还原为对象指针,应用还需要定义如何解析它。

不要直接删除self后宣称数据语义已完整保存,也不要把同一对象无限复制。若原应用依赖YAML引用关系,应保留原稿并使用它支持的加载流程。普通锚点、别名和合并键的差别可参考YAML别名转换的边界,本例进一步核对的是循环,而不是一般复用。