配置里的文字没有报错,转成JSON却少了半截,问题可能藏在井号前的那个空格里。2026年11月18日,在YAML/JSON互转工具中清空原样例,输入下面两行,再执行“转换为 JSON”:

tight: abc#def
spaced: abc #def
井号紧贴文字时被保留,前面有空格时后半段按注释处理
井号紧贴文字时被保留,前面有空格时后半段按注释处理

本次tight的值是字符串abc#def,spaced的值只有abc。两行都能完成转换,但它们表达的内容不同。成功提示并没有替我们保证“原来想传的文字一字不差”。

先检查普通标量里的结构符号

未加引号的这类值属于普通标量。在这里,井号紧贴前面的文字时是值的一部分;空格后面的井号可以开始注释。注释不属于解析后的字符串,因此不会出现在JSON输出中。

另一个常见边界是冒号后接空格。本次额外输入这一行:

label: a: b

工具提示映射项缩进错误,位置在第二个冒号附近。这不是要求把每一个冒号都删掉,而是当前位置的冒号加空格被按结构标记理解了。单看字符数量,很难解释为什么相似文字有时通过、有时报错。

要保留原文时,把整个值写成字符串

将本轮要保留的三种值都加上引号:

tight: "abc#def"
spaced: "abc #def"
label: "a: b"
带引号的三个值保留了井号、内部空格和冒号
带引号的三个值保留了井号、内部空格和冒号

这次JSON输出中的三个字符串分别保留了对应原文。这里的引号界定了值,并不会成为解析后内容的一部分;也不需要在业务里额外去除一对引号。

不能简单把“有符号就加双引号”当成所有问题的答案。双引号字符串还有自己的转义规则,例如反斜杠可能需要处理;要按YAML字符串规则保存真实内容。对于原本需要数字、布尔值或空值的字段,擅自加引号又会改变类型。

查结果时,同时看内容和类型

修改后逐项比较输出:井号后的文字是否还在,空格有没有保留,数字字段是不是意外变成字符串。不要只核对输入里的两行看起来对齐,也不要把注释丢失与业务值截断混为一谈。

遇到类似null被引号改变含义的情况,可接着看YAML带引号值与空值的区别。对配置中的原文、结构符号和类型分别确认,才知道这一对引号到底是在保存文字,还是改变了字段约定。