具有管理员或所有者权限的人员可以在仓库中创建 CODEOWNERS 文件。
您选择作为代� �所有者的人员必须具有仓库的读取权限。 当代� �所有者是团队时，该团队必须可见且必须拥有写入权限，即使团队的所有成员都已经直接通过组织成员资� �或通过另一个团队成员资� �直接拥有写入权限。
关于代� �所有者
当有人打开修改代� �的拉取请求时，将自动请求代� �所有者进行审查。 不会自动请求代� �所有者审查拉取请求草稿。 有关拉取请求草稿的更多信息，请参阅“关于拉取请求”。 不会自动请求代� �所有者审查拉取请求草稿。 如果将拉取请求转换为草稿，则已订阅通知的用户不会自动取消订阅。 更多信息请参阅“更改拉取请求的阶段”。
当具有管理员或所有者权限的人员启用必需审查时，他们也可选择性要求代� �所有者批准后，作者才可合并仓库中的拉取请求。 更多信息请参阅“关于受保护分支”。
如果文件具有代� �所有者，则在打开拉取请求之前可以看到代� �所有者是谁。 在仓库中，您可以找到文件并悬停于 上。
CODEOWNERS 文件位置
要使用 CODEOWNERS 文件，请在仓库中您要添� 代� �所有者的分支的� �目录 docs/ 或 .github/ 中，创建一个名为 CODEOWNERS 的新文件。
每个 CODEOWNERS 文件将为仓库中的一个分支分配代� �所有者。 � 此，您可以为不同的分支分配不同的代� �所有者，例如为默认分支的代� �基础分配 @octo-org/codeowners-team，为 gh-pages 分支的 GitHub Pages 站点分配 @octocat。
为使代� �所有者接收审查请求，CODEOWNERS 文件必须在拉取请求的基本分支上。 例如，如果您将 @octocat 分配为仓库 gh-pages 分支上 .js 文件的代� �所有者，则在头部分支与 gh-pages 之间打开更改 .js 文件的拉取请求时，@octocat 将会收到审查请求。
CODEOWNERS 语法
CODEOWNERS 文件使用遵循 gitignore 文件中所用大多数规则的模式，但有一些例外。 模式后接一个或多个使用� �准 @username 或 @org/team-name � �式的 GitHub 用户名或团队名称。 用户必须具有对存储库的读取权限，并且团队必须具有显式写入权限，即使团队成员已具有访问权限也是如此。 您还可以通过已添� 到用户在 your GitHub Enterprise Server instance 上帐户的电子邮件地址来引用用户，例如 user@example.com。
CODEOWNERS 路径区分大小写，� 为 GitHub 使用区分大小写的文件系统。 由于 CODEOWNERS 是由 GitHub 评估的，� 此即使是不区分大小写的系统（例如 macOS）也必须使用在 CODEOWNERS 文件中正确大小写的路径和文件。
如果 CODEOWNERS 文件中的任何行包含� 效语法，则该文件将不会被检测并且不会用于请求审查。
CODEOWNERS 文件示例
# This is a comment.
# Each line is a file pattern followed by one or more owners.
# These owners will be the default owners for everything in
# the repo. Unless a later match takes precedence,
# @global-owner1 and @global-owner2 will be requested for
# review when someone opens a pull request.
* @global-owner1 @global-owner2
# Order is important; the last matching pattern takes the most
# precedence. When someone opens a pull request that only
# modifies JS files, only @js-owner and not the global
# owner(s) will be requested for a review.
*.js @js-owner
# You can also use email addresses if you prefer. They'll be
# used to look up users just like we do for commit author
# emails.
*.go docs@example.com
# Teams can be specified as code owners as well. Teams should
# be identified in the format @org/team-name. Teams must have
# explicit write access to the repository. In this example,
# the octocats team in the octo-org organization owns all .txt files.
*.txt @octo-org/octocats
# In this example, @doctocat owns any files in the build/logs
# directory at the root of the repository and any of its
# subdirectories.
/build/logs/ @doctocat
# The `docs/*` pattern will match files like
# `docs/getting-started.md` but not further nested files like
# `docs/build-app/troubleshooting.md`.
docs/* docs@example.com
# In this example, @octocat owns any file in an apps directory
# anywhere in your repository.
apps/ @octocat
# In this example, @doctocat owns any file in the `/docs`
# directory in the root of your repository and any of its
# subdirectories.
/docs/ @doctocat
# In this example, any change inside the `/scripts` directory
# will require approval from @doctocat or @octocat.
/scripts/ @doctocat @octocat
# In this example, @octocat owns any file in the `/apps`
# directory in the root of your repository except for the `/apps/github`
# subdirectory, as its owners are left empty.
/apps/ @octocat
/apps/github
语法例外
gitignore 文件有一些语法规则在 CODEOWNERS 文件中不起作用：
- 使用
\对以#开头的模式转义，使其被当作模式而不是注释 - 使用
!否定模式 - 使用
[ ]定义字符范围
CODEOWNERS 和分支保护
存储库所有者可以添� 分支保护规则，以确保已更改文件的所有者审阅已更改的代� �。 更多信息请参阅“关于受保护分支”。
延伸阅读
- "创建新文件"
- "邀请个人仓库的协作者"
- "管理个人对组织仓库的访问"
- "管理团队对组织仓库的访问"
- "查看拉取请求审查"