标签: #冲突解决

团队协作时接口文档老打架，试试这样合并和消解冲突

从单体 OpenAPI 文件迁移到多文件结构，是解决接口文档冲突的根本方法。通过按模块拆分规范文件，并利用构建命令拼装完整文档，可将冲突率降低 90% 以上。核心操作包括：将路径、模式等定义拆分为独立文件，用 `$ref` 在入口文件中组装，并借助 Redocly CLI 进行构建与校验。对于同一模块的并发修改，可进一步按 HTTP 方法拆分文件。若冲突发生，使用 Git 的 `union` 合并策略和编辑器插件能高效解决。