VS Code 的 GitHub 插件右键“Add Comment”仅创建本地草稿，需点击“Submit comment”或按 Ctrl+Enter 才提交至 PR；SSH 克隆、子模块路径、错误远程名或权限不足均会导致上下文丢失而无法提交。
为什么右键“Add Comment”后评论不发到 GitHub？
VS Code 的 GitHub Pull Requests and Issues 插件默认只在本地缓存批注，不自动提交——这是设计行为，不是 bug。你看到的 .vscode/comment-cache.json 就是它暂存的草稿，只有点击「Submit comment」按钮（或按 Ctrl+Enter）才会调用 GitHub REST API 发送至 PR 的 draft_comments 状态。
常见错误现象包括：
- 右键选了
Add Comment，写完直接关掉面板，结果刷新后消失 - 修改文件后重新打开 PR 视图，所有未提交的批注清空（插件不跨会话持久化 draft）
- 在多根工作区中，当前文件不属于主仓库（比如开了子模块或非
origin远程），状态栏显示GitHub: Read-only (no PR context)，此时根本无法提交
解决方法很简单：
- 确保你在 PR 差异视图（不是普通编辑器）中操作，且光标停在变更行上
- 写完评论后，务必点击右上角的
Submit comment按钮，或聚焦输入框后按Ctrl+Enter - 若状态栏提示只读，检查是否已将主仓库文件夹设为活动文件夹（右键文件夹 →
Set as Folder Workspace）
SSH 克隆的仓库为什么识别不了 PR 上下文？
插件依赖 git config --get remote.origin.url 解析仓库 owner/repo，但它的正则只匹配 HTTPS 格式（如 @#@#@#@#@#@#@#@#@#@0），对 SSH 地址 git@github.com:org/repo.git 完全失效，导致 github.repository 为空、PR 查询失败。
这不是权限问题，而是解析逻辑硬编码所致。即使你已登录、Token 有效、远程存在 open PR，插件也查不到。
你可以这样验证：
- 终端运行
git config --get remote.origin.url，如果输出是git@github.com:org/repo.git，就踩中了这个坑 - 检查
git remote -v，若显示的是upstream而非origin，插件也会跳过（它只认origin）
临时绕过方法：
- 改用 HTTPS 克隆：先
git remote set-url origin @#@#@#@#@#@#@#@#@#@0 - 或强制指定上下文，在
.vscode/settings.json中加：{ "githubPullRequests.repository": "org/repo" }注意格式必须是"owner/repo"，不能带https://或git@
如何确保评论真正关联到 PR 而不是子模块？
当你在子模块路径下打开一个文件（例如 libs/utils/src/index.ts），插件会基于当前文件路径向上查找 .git，误判为子模块独立仓库，从而忽略主 PR 所属的父仓库上下文——结果就是评论发不出、审批按钮灰掉、甚至看不到 PR 列表。
这不是 UI 延迟，是路径解析优先级导致的上下文污染。
真实使用场景包括：
- 单体仓库含多个
git submodule - 使用 pnpm workspace 或 turborepo，代码分散在不同子目录
- 直接从文件管理器双击子模块内文件启动 VS Code
关键判断依据是状态栏：如果显示 GitHub: org/submodule-name（而非主仓库名），说明已掉进子模块陷阱。
应对方式只有两个：
- 关闭当前窗口，从主仓库根目录启动 VS Code（
code .） - 或在主仓库根目录下打开命令面板（
Ctrl+Shift+P），运行GitHub Pull Requests: Refresh Pull Requests强制重载上下文
本地审查时，怎样避免“评论写了却没人收到”？
插件提交评论后，GitHub 会按 PR 的 reviewers 和参与者自动发通知，但前提是：
- 你评论的是 open 状态的 PR（draft 状态不会触发通知）
- 评论目标行确实存在于该 PR 的 diff 中（比如你在 base 分支上乱点，评论不会绑定到变更）
- 你的 GitHub 账号有对应仓库的 read 权限（私有组织下常被忽略）
最容易被忽略的一点：如果你用的是 GitHub SSO（企业账号），OAuth Token 必须包含 repo scope —— 仅 user:email 不够。登录后可在 GitHub Settings → Applications → Authorized OAuth Apps 里检查 token 权限。
另外，@提及同事时要注意：
- 必须用
@username（不是邮箱或全名） - 对方需是该仓库的协作者或有 read 权限（否则 @ 不亮、无通知）
- 提及要写在评论正文里，不能只放在标题或折叠区
插件不会校验提及有效性，所以写完记得手动点一下 @ 后面的名字是否变蓝、是否有下拉建议。
有些团队把 PR 模板写在 .github/pull_request_template.md 里，但插件不读这个——它只管 diff 和评论链。想让新评论自动带模板，得靠 GitHub Actions + pull_request_target 事件补全，VS Code 层做不到。
这整套流程里，最脆弱的环节其实是上下文绑定：它既依赖 Git 配置的正确性，又受 VS Code 工作区结构影响，还和 GitHub 的 OAuth scope、PR 状态强耦合。稍有偏差，你就从“高效评审”退回到“复制粘贴到网页”。
