vscode需装github官方插件并登录才能启用pr审查功能;评论须锚定具体代码行,未提交则丢失;gitlens提供行级责任标注,sonarlint和code spell checker自动拦截低级问题。

VSCode 本身不提供开箱即用的代码审查功能,必须靠插件组合才能完成从查看变更、添加评论到跟踪状态的完整流程。核心路径就一条:装插件 → 打开 PR → 行内评论 → 提交同步。
装 GitHub Pull Requests and Issues 插件并登录账号
没这一步,后续所有操作都无效。它不是可选增强,而是审查能力的基础设施。
- 在扩展面板(
Ctrl+Shift+X)搜GitHub Pull Requests and Issues,认准发布者是GitHub的官方版本 - 安装后右下角会出现 GitHub 图标,点击或运行命令
GitHub: Sign In完成 OAuth 授权 - 授权成功后,左侧活动栏出现 GitHub 图标;点开若看不到 PR 列表,检查两点:
.git目录是否存在、origin远程地址是否为github.com/xxx/yyy
在 diff 视图中锚定行添加评论
评论必须绑定到具体代码行,否则 GitHub 不会将其关联到变更位置,容易失效或被忽略。
- 在 GitHub 侧边栏 → Pull Requests → 点击目标 PR → 展开文件树,打开变更文件
- 光标停在某行,右键 →
Add Comment,支持@提及、```js代码块、链接等 Markdown 语法 - 如需批量写评再统一提交,先右键某行 →
Start Review,之后所有Add Comment都暂存,最后点顶部Submit Review - ⚠️ 未提交的评论只存在本地,关掉窗口即丢失;建议写完一条就点
Post,别攒太多
用 GitLens 补上下文,避免“这行谁写的?为什么这么改?”
只看 diff 很难判断修改意图,GitLens 能立刻告诉你某行的历史归属和演进路径。
- 安装
GitLens插件(非官方但事实标准),重启 VSCode - 按
Ctrl+Shift+P输入GitLens: Toggle File Blame Annotations开启行号旁的责任标注 - 鼠标悬停看到
abc1234 · @alice · 2 days ago?点击直接跳转 commit;右键某行 →GitLens: Show Commit in Timeline查该行全部修改记录 - ⚠️ Blame 默认基于当前分支
HEAD,刚rebase过可能显示错误作者——此时右键文件 → 切换为基于原始 commit 的 blame
配合 SonarLint 和 Code Spell Checker 拦截低级问题
人工审查不该花时间找拼写错误、空指针或硬编码。这些交给插件标出,人专注逻辑与设计。
-
Code Spell Checker:实时标出变量名、注释里的拼写错误(如recieve→receive),项目根目录加.cspell.json可录入团队术语 -
SonarLint:连接 SonarQube 或用离线规则,提示安全漏洞、坏味道、复杂度超标;对 JS/Java/Python 均有效 - 建议开启
Format On Save+ESLint自动修复格式问题,减少 review 中的风格争议
真正卡住人的不是怎么点按钮,而是评论写在哪、有没有上下文支撑、以及未提交的评论是否被遗忘。这些细节不处理好,审查就变成形式主义。











