GitHub官方插件支持VSCode内浏览、创建、审查和合并PR及Issues,需OAuth登录、本地Git仓库关联GitHub远程地址,并依赖匹配的Git用户信息。

VSCode 的 GitHub Pull Requests and Issues 插件(官方出品,由 GitHub 官方维护)能让你在编辑器内直接浏览、创建、审查和合并 PR,无需频繁切换网页端。它深度集成 GitHub REST API 和 Git 本地状态,体验流畅但需正确配置才能发挥全部能力。
安装与基础登录
在 VSCode 扩展市场搜索 “GitHub Pull Requests and Issues”,安装后重启(或启用)。首次使用会弹出登录提示——点击后跳转到 GitHub 授权页,勾选 public_repo、workflow、read:user 等必要权限(插件会明确列出),授权完成后自动回连。不支持 PAT(Personal Access Token)手动输入,必须走 OAuth 流程。若登录失败,检查系统时间是否准确、是否启用了严格隐私模式拦截了重定向。
关联仓库与加载 PR/Issues
插件只对已克隆到本地、且远程为 GitHub(github.com 或 GitHub Enterprise)的 Git 仓库生效。打开项目文件夹后,侧边栏会出现 GitHub 图标;点击进入,顶部显示当前分支和远程源。确保 git remote get-url origin 返回的是 HTTPS 或 SSH 格式的 GitHub 地址(如 https://github.com/owner/repo.git)。加载后,左侧列表默认展示当前仓库的 Open PRs 和 Open Issues。可点击顶部筛选器切换状态(All / Created by you / Assigned to you / Mentioning you)。
创建与提交 Pull Request
完成本地提交后,在 GitHub 侧边栏点击 “+ Create Pull Request” 按钮:
- 选择目标分支(默认为远程
main或master,可下拉更改) - 填写标题和描述(支持 Markdown,可引用 issue:#123)
- 勾选 “Create draft pull request” 可建草稿 PR
- 点击 “Create” 后,插件自动推送当前分支并跳转到新 PR 页面(网页端),同时在 VSCode 中打开 PR 概览视图
注意:分支名会自动生成(如 your-branch-name),不支持自定义推送分支名;若本地分支已存在远程追踪,插件会复用该分支而非新建。
审查代码与交互式评论
在 PR 视图中,点击 “Files changed” 标签可逐个查看差异。支持:
- 点击行号左侧加号(+)添加行级评论(支持 @ 提及协作者)
- 右键某段 diff 可选择 “Start a review” 发起正式审查,再统一提交
- 直接在编辑器中修改代码 → 点击 “Stage changes” → “Commit and push” 快速提交修复
- 点击 “Merge pull request” 可在 VSCode 内完成合并(需有权限),支持 squash / merge / rebase 三种策略
所有操作实时同步 GitHub,无需刷新网页。评论和审查状态也会即时反映在侧边栏 PR 列表中。
管理 Issues 与快捷跳转
在 GitHub 侧边栏切换到 Issues 标签,可查看、搜索、排序问题。点击任一 Issue 后,右侧显示详情、评论和关联 PR。关键便利功能:
- 在编辑器中右键任意代码文件 → “Open on GitHub” → 自动跳转到对应文件的 GitHub 页面
- 在 Issue 描述或评论中点击 #123 链接,VSCode 会自动打开对应 Issue 视图
- 在源码中写
Fixes #456并提交,合并后该 Issue 将被自动关闭(符合 GitHub 语义)
不复杂但容易忽略:插件依赖本地 Git 配置中的 user.name 和 user.email,需与 GitHub 账户邮箱一致,否则部分操作(如签名提交)可能异常。










