GitHub Copilot
可在编辑器、终端与 GitHub 中使用的 AI 编程代理。
GitHub Copilot 是贯穿代码编辑器与 GitHub 开发流程的 AI 编程助手，可辅助写代码、解释仓库、提出审查意见，并处理交给代理的开发任务。
GitHub Copilot 能做什么
同一产品中既有逐条接受的建议，也有会编辑文件、运行工具和准备拉取请求的代理流程。使用前应决定任务边界，以及哪些步骤需要自己审阅。
编辑建议：把任务写成可验证的行为，例如输入为空时应返回什么，而不只说“优化代码”。保留复现方法与现有测试，更容易判断生成改动是否解决了原问题。
在编写过程中获得代码建议
Copilot 可在输入时给出内联代码建议，也可以按自然语言描述生成或修改代码。开发者决定是否采用，并检查它是否符合项目现有接口。
围绕具体仓库和文件提问
在 GitHub 文件页面可唤起 Copilot，询问文件作用、改进方向或测试覆盖点。编辑建议：先要求指出关键入口与调用关系，再进入修改。
把明确任务交给编码代理
代理可研究仓库、编辑文件、使用工具并形成待审阅的改动。GitHub 的云端流程可从 issue 开始，完成后以 pull request 交给开发者检查。
给改动增加一次审查视角
Copilot 能对代码和 pull request 给出摘要或修改建议。可提供项目规范帮助聚焦问题，但审查意见本身也应由开发者判断。
- 核心用途
- 代码建议、仓库问答与代理改动
- 可完成的工作
- 接手项目、修复缺陷和补齐测试
- 如何开始
- 从仓库文件提问或支持的编辑器开始
- 使用条件
- 按方案、客户端及组织策略使用
如何使用 GitHub Copilot
- 选一个可读的仓库入口
在 GitHub 打开目标文件并使用 Copilot 提问，或使用受支持的编辑器入口。先检查当前账户与组织是否开放所需能力。
- 提供任务与项目约束
写明预期行为、相关文件、规范和测试要求。可借助自定义指令与仓库上下文，使回答更贴近项目约定。
- 从建议过渡到受控修改
先理解建议再接受；使用代理时查看计划、涉及工具与改动范围。云端任务返回 pull request 后，对照原 issue 逐项检查。
- 读差异并运行对应验证
检查生成的文件差异、测试和错误处理，再决定是否合并。Copilot 审查可能遗漏问题或给出误报，需要人工补充判断。
接手一个不熟悉的代码仓库
适合：新成员、维护者
- 准备输入
- 目标仓库、一个用户请求的入口文件、运行和测试说明。
- 操作方法
- 编辑建议：先问文件职责、依赖与调用路径，再逐一打开被引用文件核对；整理出从入口到主要业务函数的阅读顺序。
- 预期交付物
- 可供继续阅读的项目路径说明。
- 人工检查
- 确认路径真实存在，区分代码实际行为与助手推测，不能把解释当成执行结果。
修复一项可复现的小缺陷
适合：有仓库写入权限的开发者
- 准备输入
- 复现步骤、预期行为、允许改动的文件范围、测试命令。
- 操作方法
- 编辑建议：把边界清楚的 issue 交给可用代理；要求最小修改，检查返回的 diff，并运行能复现原问题的检查。
- 预期交付物
- 经过审阅的修复分支或 pull request。
- 人工检查
- 验证原缺陷消失，正常输入仍可用；审核新增依赖、权限和意外文件修改。
为核心函数补充有价值的测试
适合：维护测试的开发者
- 准备输入
- 函数实现、现有测试、重要边界输入与异常约定。
- 操作方法
- 编辑建议：让 Copilot 先列未覆盖行为，再挑真正影响业务的案例生成测试；读断言并确认修改前会暴露问题。
- 预期交付物
- 覆盖关键行为的测试补丁。
- 人工检查
- 排除仅重复实现逻辑或永远通过的断言，确认测试稳定且能解释失败原因。
界面与参考图片
开始前需要了解
功能可用性不是所有入口一致
可用能力受订阅方案、客户端和组织政策影响。某个演示中出现的代理、模型或工具，不代表当前编辑器与账户也已开放。
审查意见可能遗漏或误报
官方提醒代码审查可能漏掉问题，也可能把不存在的问题标出来。编辑建议：要求可复现案例和代码依据，不因建议措辞肯定就直接改动。
代理生成代码仍需审阅
代理可执行多步骤任务，但开发者仍负责审查与批准。官方也提示相关能力可能生成不准确或不安全的代码，关键路径需要实际验证。
有免费与付费计划；部分功能、模型和请求额度依计划而异。
账号权限、费用与可用功能请以官方入口的当前说明为准。重要结果应先检查，再用于实际工作。
常见问题
GitHub Copilot 只能补全一行代码吗？
不止。它还支持代码解释、仓库问答、修改和审查，并有可处理多步骤开发任务的代理能力；具体入口取决于账户和客户端。
可以直接把一个 issue 分配给 Copilot 吗？
在具备相应方案、权限并已启用云端代理的仓库中可以。官方流程会生成 pull request，随后仍需检查差异与结果。
Copilot 说测试通过，可以立即合并吗？
建议查看实际测试结果并验证改动范围。官方流程要求审阅代理生成的 pull request；编辑建议：特别检查原复现用例与相关回归。
Copilot 代码审查能替代同事审查吗？
应当作为补充。官方说明存在遗漏与误报，应结合人工审查，尤其关注大范围修改和复杂逻辑。
