如何在GitHub仓库中设置多个CODEOWNERS文件

GitHub 官方默认仅支持单仓库的根目录、.github/或docs/路径下存在1个生效的CODEOWNERS文件，多文件拆分需求可通过GitHub Action自动合并的方案实现，以下是可直接复用的实现流程：

1. 拆分CODEOWNERS规则 #

• 在仓库中新建存放拆分配置的目录，例如.github/codeowners/
• 按业务域、模块等维度拆分规则，写入不同配置文件，比如frontend、backend、infra等，每个文件的语法完全遵循官方CODEOWNERS规范。

2. 配置自动合并GitHub Action #

在.github/workflows/merge-codeowners.yml中添加如下工作流配置，触发规则可根据自身需求调整：

name: Merge Multiple CODEOWNERS Files
on:
  push:
    branches: [ main ]
    # 仅当拆分的CODEOWNERS配置或当前工作流文件变更时触发
    paths:
      - '.github/codeowners/**'
      - '.github/workflows/merge-codeowners.yml'

# 授予工作流仓库内容写入权限
permissions:
  contents: write

jobs:
  merge-codeowners:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          ref: ${{ github.head_ref }}
          
      - name: 合并所有拆分的CODEOWNERS配置
        run: |
          # 写入自动生成文件标记，禁止手动修改根CODEOWNERS
          echo "# AUTO GENERATED FILE - DO NOT EDIT MANUALLY" > .github/CODEOWNERS
          echo "# Modify files under .github/codeowners/ directory instead" >> .github/CODEOWNERS
          # 按文件名顺序合并所有拆分配置，可自定义排序规则调整优先级
          find .github/codeowners -type f | sort | xargs cat >> .github/CODEOWNERS
          
      - name: 自动提交更新后的CODEOWNERS
        uses: stefanzweifel/git-auto-commit-action@v5
        with:
          commit_message: "chore: auto update merged CODEOWNERS"
          file_pattern: .github/CODEOWNERS

3. 可选优化配置 #

• 可以在合并步骤前新增语法校验逻辑，调用github/codeowners-checker等工具校验拆分配置的合法性，避免合并后出现无效规则。
• 建议在仓库分支保护规则中，禁止普通开发者直接修改根目录下的生效CODEOWNERS文件，仅保留维护人员对.github/codeowners/目录的修改权限，避免手动修改被自动合并覆盖。
• 若需要调整规则优先级，只需调整合并步骤中的文件排序规则即可，CODEOWNERS默认后定义的规则优先级更高。

*注意：该方案完全兼容官方CODEOWNERS的所有规则，最终生效的合并文件和手动编写的单文件逻辑完全一致，不会影响原有CODEOWNERS的匹配、PR自动指派等功能。

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