如何在多文件中批量注释Azure DevOps Pipeline YAML阶段？

问题场景 #

需要给多个YAML文件中的指定Azure DevOps Pipeline阶段代码批量添加注释，原代码片段如下：

- stage: "check_code"
    jobs:
      - job: "check_code"
        pool:
          vmImage: 'windows-latest'
        steps:
          - template: check_code.yml@templates
            parameters:
              projectName: '$(projectName)'

期望注释后的效果：

# - stage: "check_code"
# jobs:
  # - job: "check_code"
    # pool:
      # vmImage: 'windows-latest'
    # steps:
      # - template: check_code.yml@templates
        # parameters:
          # projectName: '$(projectName)'

遇到的问题：Notepad++的「替换为」框无法直接粘贴多行带注释的代码，导致替换操作无法完成。

可行替换方案 #

方案一：纯文本粘贴多行替换内容 #

1. 打开Notepad++，新建空白文档，将期望的带注释代码完整粘贴进去，确保缩进、换行、#的位置完全符合要求。
2. 选中所有带注释代码，按Ctrl+C复制。
3. 按Ctrl+Shift+F打开「在文件中查找」对话框，在「查找内容」框粘贴原阶段代码，保证格式和目标文件中的代码完全一致（包括缩进和换行）。
4. 点击「替换为」输入框，右键选择粘贴为纯文本（或先将复制内容粘贴到系统记事本，再复制后粘贴到替换框，清除格式干扰）。
5. 在「目录」选项中选择要处理的文件所在文件夹，按需勾选「查找所有子目录」，最后点击「全部替换」即可批量完成注释。

方案二：正则表达式精准替换 #

如果需要更灵活的匹配（比如适配不同换行符格式），可以用正则表达式实现：

1. 打开「在文件中查找」对话框，切换到正则表达式模式。
2. 在「查找内容」框输入匹配原代码的正则（注意转义特殊字符，换行符根据原文件格式选\r\n或\n，以下以Windows换行符为例）：

- stage: "check_code"\r\n    jobs:\r\n      - job: "check_code"\r\n        pool:\r\n          vmImage: 'windows-latest'\r\n        steps:\r\n          - template: check_code.yml@templates\r\n            parameters:\r\n              projectName: '\$\(projectName\)'

3. 在「替换为」框输入带注释的代码，用\r\n表示换行：

# - stage: "check_code"\r\n# jobs:\r\n  # - job: "check_code"\r\n    # pool:\r\n      # vmImage: 'windows-latest'\r\n    # steps:\r\n      # - template: check_code.yml@templates\r\n        # parameters:\r\n          # projectName: '$(projectName)'

4. 选择目标文件目录后，点击「全部替换」即可完成批量注释。

内容的提问来源于stack exchange，提问作者albbla91