如何移除OpenAPI YAML规范中带env:prod标记的接口端点

你之前认为yq无法实现该需求是不准确的，主流v4版本yq完全支持这类条件筛选删除操作，以下是两种可直接落地的方案：

方案1：yq命令直接处理（无额外依赖，推荐） #

核心逻辑是遍历OpenAPI规范的paths节点，逐层筛选出带env: prod属性的HTTP操作节点（get/post/put/delete等）直接删除，额外可选清理删除操作后残留的空路径节点，避免无效结构。
直接执行以下命令即可，需要原地修改文件的话在eval后加-i参数：

yq eval '
  with(.paths[];
    del(.[] | select(.env == "prod"))
  )
  | del(.paths | select(length == 0))
' openapi.yaml

如果你的env: prod标记是加在路径层级而非单个HTTP方法层级，只需要调整选择器的判断层级即可，写法逻辑一致。

方案2：自定义脚本处理（适配复杂if/else逻辑场景） #

如果后续需要叠加更复杂的判断逻辑，比如针对不同env值做不同的字段修改、多条件匹配等，可以用Python搭配PyYAML写轻量处理脚本，逻辑完全可控：

import yaml
from pathlib import Path

# 读取目标OpenAPI文件
target_file = Path("openapi.yaml")
with open(target_file, "r", encoding="utf-8") as f:
    spec_content = yaml.safe_load(f)

paths = spec_content.get("paths", {})
to_del_path = []

for path, op_map in paths.items():
    # 收集当前路径下需要删除的HTTP方法
    to_del_op = []
    for method, op_config in op_map.items():
        # 此处可自由扩展任意if/else判断逻辑
        if isinstance(op_config, dict) and op_config.get("env") == "prod":
            to_del_op.append(method)
    # 执行删除
    for op in to_del_op:
        del op_map[op]
    # 记录空路径
    if not op_map:
        to_del_path.append(path)

# 清理空路径
for p in to_del_path:
    del paths[p]

# 写回修改后的内容
with open(target_file, "w", encoding="utf-8") as f:
    yaml.safe_dump(spec_content, f, allow_unicode=True, sort_keys=False)

脚本执行前先安装依赖：pip install pyyaml即可。

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