VSCode需安装vscode-pull-request-github插件并登录GitHub账号才能使用PR面板；仅对Git初始化且关联远程仓库的项目生效；Review需在diff视图中添加评论并完成提交；本地修改后需手动push，合并后需手动同步主分支。
侧边栏点不开 PR 面板？先确认插件和登录状态
VSCode 默认不带 GitHub PR 功能，必须装 vscode-pull-request-github 扩展，且完成 GitHub 账号授权。常见现象是点击左侧活动栏没出现 GitHub 图标，或点了图标却提示 “You are not signed in” —— 这说明插件已安装但未登录。
- 按
Cmd+Shift+P（Mac）或Ctrl+Shift+P（Win/Linux），输入GitHub: Sign in to GitHub，选择 Token 方式（推荐），确保 Token 至少有repo和workflow权限 - 登录后，GitHub 图标会出现在活动栏；若仍不显示，检查
View: Toggle Activity Bar Visibility是否被意外关闭 - 插件只对 Git 初始化过的文件夹生效：打开项目根目录，运行
git remote get-url origin确认已关联远程仓库
点开 PR 后怎么真正 Review（不是只看 diff）
“Review” 不等于打开文件扫一眼。在侧边栏 Pull Requests 视图中点击某条 PR，右侧展开详情页，关键操作都在这里：
- 点击某个变更文件 → 自动进入 diff 视图（不是原文件），新增行绿色、删除行红色，只有这时右键才出现
Start a review comment - 选中 1 行或多行 → 右键 →
Start a review comment→ 输入内容（支持@username、代码块```js、列表）→ 点击Add single comment或先存为草稿 - 多处评论写完后，右上角点
Finish your review，再选Approve/Comment/Request changes—— 不点这个，评论不会提交到 GitHub - 若 PR 已有 CI 检查（如 GitHub Actions），状态会显示在 PR 详情顶部，
Required checks are not green时点Approve会被阻止
Checkout 后本地改完，怎么让新 commit 关联回原 PR
点击 PR 条目右侧的 Checkout 按钮，插件会自动执行：git fetch origin pull/123/head:pr-123 并切换到该分支。此时你本地处于 pr-123 分支：
- 所有新
git commit都会自动加到原 PR 的提交历史里，无需手动 push 到origin的某个特定 ref - 但注意：插件不会帮你 push。改完后仍需手动
git push（VSCode 源代码管理面板点 ↑ 按钮即可） - 如果 PR 目标分支（如
main）在此期间有新提交，你 push 时可能触发冲突提示Validation Failed: The base branch has changed—— 此时需先git rebase main或git merge main，再 push
为什么点 Merge 按钮没反应或报错
侧边栏 PR 详情页底部有 Merge Pull Request 按钮，但实际能否点，取决于三件事：
- 当前用户是否具备仓库的写入权限（organization 设置里看 team role，不是仅靠 fork 权限）
- PR 的所有 required reviews 已通过，且 required status checks 全部成功（CI 通过）
- 目标分支（如
main）未设为 protected，或你满足其合并策略（如 require linear history、require signed commits）
如果按钮灰掉，把鼠标悬停上去，VSCode 会显示具体拦截原因，比如 This branch is protected and cannot be merged 或 At least one approving review is required。这类限制只能由 repo admin 在 GitHub.com 的 Settings → Branches 页面调整，VSCode 无法绕过。
真正容易被忽略的是：Merge 操作本身不改变你本地当前分支。即使 PR 合并成功，你的 pr-123 分支还留着，main 也还是旧的 —— 得手动 git checkout main && git pull 才能同步。
