如何在YAML中注释一行?


当前回答

在.gitlab-ci.yml文件中,以下操作有效:

注释掉块(多行):选择整个块部分>Ctrl K C取消注释已注释的块(多行):选择整个块段>Ctrl K U

其他回答

YAML支持内联注释,但不支持块注释。

来自维基百科:

注释以数字符号(#)开头,可以从一行的任何位置开始,并一直持续到该行的结尾

与JSON的比较,同样来自维基百科:

语法差异很细微,在实践中很少出现:JSON允许扩展字符集(如UTF-32),YAML需要逗号、等号和冒号等分隔符后的空格,而JSON则不需要,JSON的一些非标准实现将语法扩展到包括Javascript的/*…*/评论。处理这种边缘情况可能需要在解析为内联YAML之前对JSON进行少量预处理。

# If you want to write
# a block-commented Haiku
# you'll need three pound signs

本规范仅描述了标记注释的一种方式:

显式注释由“#”指示符标记。

这就是全部。没有任何块注释。

另一种方法:

If

您的YAML结构有定义良好的字段供您的应用程序使用您可以自由添加其他字段,而不会干扰您的应用程序

then

在任何级别上,您都可以添加一个名为“说明”、“注释”或“注释”等的新块文本字段

例子:

而不是

# This comment
# is too long

use

Description: >
  This comment
  is too long

or

Comment: >
    This comment is also too long
    and newlines survive from parsing!

更多优点:

如果注释变得大而复杂,并且具有重复模式,则可以将其从纯文本块升级为对象你的应用将来可能会阅读或更新这些评论

如果您将Eclipse与YEdit插件(一个.yaml文件的编辑器)一起使用,您可以通过以下方式注释多行:

选择要注释的行,然后Ctrl+Shift+C

要取消注释,请执行相同的步骤。

在Azure DevOps浏览器(管道YAML编辑器)中,

Ctrl+K+C注释块

Ctrl+K+U取消注释块

还有一个“切换块注释”选项,但这不适用于我。

还有其他“奇怪”的方式:右键单击以查看“命令调色板”或F1

然后选择光标选项。

现在只是#的问题。

或者更聪明的[Ctrl+K]+[Ctrl+C]