Copilot 代码审查以"仅评论"模式工作，不占用 Approval 名额。支持个人开启、仓库 Ruleset、组织级 Ruleset 三种配置方式。Copilot 会逐行分析 diff，留下建议，你可以单条接受或批量合并为一次提交。注意：2026 年 6 月起审查运行将消耗 GitHub Actions 分钟数。

GitHub Copilot 代码审查：自动 PR Review 配置与使用指南

什么是 Copilot 代码审查

Copilot 可以在 PR 创建或有新 Push 时自动触发，分析代码变更并留下逐行评论。特点：

• 仅评论模式：Copilot 的 Review 不会计入 PR 所需的 Approval 数量
• 支持自定义指令：可通过 .github/copilot-instructions.md 配置审查关注点（只读取前 4000 字符）
• 可接受建议：单条接受或批量合并多条建议为一次提交

三种配置层级

个人开启（Copilot Pro / Pro+）

1. 点击右上角头像 → Your Profile
2. 进入 Copilot settings
3. 开启 Automatic Copilot code review

开启后，你参与的 PR 在打开时会自动触发 Copilot Review。

仓库级（Repository Ruleset）

1. 进入仓库 Settings → Rules → Rulesets
2. 创建或编辑一个 Branch Ruleset
3. 在 Branch rules 中勾选 Automatically request Copilot code review
4. 可选：勾选"review new pushes"（新 Push 时重新触发）和"review draft PRs"（草稿 PR 也触发）

组织级（Organization Ruleset）

1. 进入组织 Settings → Repository → Rulesets
2. 创建 Branch Ruleset，设置包含/排除的仓库范围
3. 同上，勾选 Automatically request Copilot code review

组织级配置会覆盖指定仓库范围内的所有 PR，适合统一管控代码质量标准的企业团队。

手动请求审查

在 PR 页面右侧 Reviewers 区域选择 Copilot，或在 PR 评论中直接 @Copilot：

@copilot 帮我审查这段认证逻辑，重点关注权限越界的可能

Copilot 通常在 30 秒内开始留下评论。

接受审查建议

Copilot 留下的建议可以：

• 单条点击 Accept suggestion 直接提交
• 批量勾选多条，合并为一个提交（减少提交历史噪音）

配置自定义审查指令

在 .github/copilot-instructions.md 中加入审查相关指令：

## 代码审查关注点

- 所有用户输入必须经过参数化查询，禁止字符串拼接 SQL
- 新增的公开方法需要有 JSDoc 注释
- async 函数必须有 try/catch 或 .catch() 兜底

注意：Copilot 代码审查只读取该文件的前 4000 字符，内容过长时后面的指令会被忽略。

Runner 配置

默认使用 GitHub 托管的 Runner。自定义 Runner 需满足：

• 系统：Ubuntu x64（仅支持此平台）
• 类型：ARC 管理的 Runner（官方支持）
• 防火墙放行以下域名：
  • api.githubcopilot.com
  • uploads.github.com
  • user-images.githubusercontent.com

更新 copilot-setup-steps.yml：

jobs:
  copilot-setup-steps:
    runs-on: [self-hosted, ubuntu-latest]
    steps:
      - name: 检出代码
        uses: actions/checkout@v4

费用说明

2026 年 6 月起，Copilot 代码审查的运行会消耗 GitHub Actions 分钟数，请关注套餐额度。自托管 Runner 不消耗 GitHub Actions 分钟，但需要自行维护 Runner 基础设施。

与 Cursor / Claude Code 的对比

Cursor 和 Claude Code 的代码审查是本地 IDE 级别的实时建议，而 Copilot 代码审查是 PR 级别的协作工作流——更适合团队 Review 场景，而不是个人编写时的即时反馈。

常见问题

Q: Copilot Review 会占用我设置的必须 Approval 数量吗？

A: 不会。Copilot Review 是"仅评论"模式，不算作有效 Approval，仍需其他有写权限的成员进行人工 Approve。

Q: 自动触发的审查会每次 Push 都运行吗？

A: 取决于 Ruleset 配置。如果勾选了"review new pushes"，每次 Push 都会重新触发；否则只在 PR 创建时触发一次。

Q: 自定义指令超过 4000 字符怎么办？

A: 把审查优先级最高的指令放在文件开头，确保最关键的约束在 4000 字符以内。或者考虑为不同仓库维护不同的精简版指令文件。