CI流水线中sed修改YAML指定version字段失败，求排查原因

问题场景 #

现有如下YAML文件：

openapi: 3.0.0
info:
  title: Test
  description: >-
    This is the official REST API documentation for all available routes
    provided by the **Test** plugin.
  version: 2.0.0
servers:
  - url: https://entwicklungsumgebung
components:
  securitySchemes:
    basicAuth:
      type: http

需要在CI流水线中修改info节点下的version字段值，但文件中存在test_version、prod_version等类似字段不能被误替换。

最初使用sed -i '' 's/version: .*/version: 3.0.0/' test.yml，会匹配所有包含version的内容，误改其他字段；添加行首锚点^后，命令变为sed -i '' 's/^version: .*/version: 3.0.0/' test.yml，却无法替换目标version字段。

问题原因 #

目标version字段位于info节点下，行首存在缩进空格（示例中是2个空格），而^表示严格匹配行首位置，原命令只会匹配行首直接是version:的行，自然匹配不到带缩进的目标行。

解决办法 #

方法1：适配缩进的sed命令 #

如果确定目标字段的缩进固定（比如2个空格），可以直接在匹配模式中加入对应空格：

sed -i '' 's/^  version: .*/  version: 3.0.0/' test.yml

如果不确定缩进数量（比如YAML格式可能调整），可以用正则匹配任意数量的空白字符，同时保留原有缩进：

sed -i '' 's/^\( *\)version: .*/\1version: 3.0.0/' test.yml

这里\( *\)捕获行首的空格，\1在替换时保留这些空格，确保YAML格式不被破坏。

方法2：用YAML专用工具更可靠 #

sed是基于文本匹配的工具，对结构化的YAML文件来说，一旦格式（如缩进、换行）变化就可能失效。更稳妥的方式是使用YAML解析工具，比如yq：

yq eval '.info.version = "3.0.0"' -i test.yml

该命令直接通过YAML节点路径定位修改，完全不用担心误匹配或格式破坏问题，适合CI流水线这类需要稳定性的场景。

内容的提问来源于stack exchange，提问作者Mr. Jo