escaping - 如何在 YAML 字符串中转义冒号和其他特殊字符？

Question

我有以下 YAML 片段:

description: |
  "API for bean consuming applications.
  Examples: painted pony, lima bean"

Swagger editor尽管有引号，但将冒号 ( : ) 解释为特殊字符。

根据对 this question 的公认答案, 冒号不应被视为特殊字符。

这是 Swagger 的错误还是需要在引用文本文字中使用冒号的转义序列？

我试图使用 YAML specification 找出这个问题。但放弃了。

我必须如何阅读该规范才能回答问题？

YAML 中的单引号( ' )和双引号( " )有区别吗？

管道( | )或大于( > )结构是否也只影响换行符处理或特殊字符的处理？

Answer 1

我认为这是 swagger 中的一个错误，但我在其他编辑器中看到了问题，例如突出显示 YAML 时。

当字符串标量被 single quotes 包围时'....'该字符串中唯一可以完成的转义是插入双单引号以指示单引号:

'It''s a good question'

当 double quotes , "...." ，绕过使用反斜杠( \ )进行转义的标量字符串，并且您必须至少转义反斜杠和双引号。此外，您可以转义其他特殊字符，如换行符 ( \n ) 并通过在行尾前面加上反斜杠来转义行尾。

YAML 规范说有 no way to escape characters inside literal scalars (以 | 开头)，因此您不能插入额外的换行符或其他转义序列。

对于折叠样式 ( > )，转义行为与文字标量一样。

除了普通标量(那些没有任何引号或 >/ | )之外的所有字符串标量都可以包含 :后跟空格没有问题，如果编辑器以不同的方式解释，这是可以理解的(因为完整的 YAML 解析很昂贵)，但不正确。