必须登录GitHub账号、打开仓库根目录工作区、进入PR差异视图，三者缺一不可；Add Comment仅为本地草稿，需Ctrl+Enter或点击Submit comment才提交至GitHub。
VSCode安装GitHub Pull Requests and Issues插件必须做三件事
不登录、不设工作区、不进PR差异视图，插件就只是个图标——它不会识别你的仓库上下文，更没法提交评论。
安装后必须立即完成这三步：
- 运行
GitHub: Sign In命令，用 Browser Login 方式授权（Token 方式在 2026 年已逐步弃用） - 确保你打开的是整个 Git 仓库根目录（不是子模块、不是某层子文件夹），右下角状态栏应显示
GitHub: org/repo，而非GitHub: Read-only - 从侧边栏 GitHub 视图中点开一个 PR，进入「文件差异」界面（URL 含
/diff或标题为 “Changes”），这才是唯一支持Add comment的上下文
为什么Add Comment写了却发不出？关键看光标位置和提交动作
右键弹出的Add comment菜单，本质是创建本地草稿，不是发送操作。常见失效场景全是“以为写完就发了”。
真实行为链是：光标停在变更行 → 右键 → Add comment → 输入文字 → 按 Ctrl+Enter 或点击 Submit comment。漏掉最后一步，草稿存在.vscode/comment-cache.json里，关面板就丢。
特别注意：
- 光标必须落在 diff 区域的
+或-行上（即有背景色高亮的新增/删除行），普通代码行右键无此选项 - 多根工作区下，若当前编辑器标签页来自子模块路径（如
libs/core/src/index.ts），插件会自动降级为只读，Submit comment按钮灰掉 - SSH 克隆的仓库大概率失败：插件解析
git@github.com:org/repo.git时正则不匹配，github.repository为空；临时解法是在.vscode/settings.json里硬编码"githubPullRequests.repository": "org/repo"
团队评审时 VSCode 批注和网页端不一致？同步机制有延迟但不丢数据
VSCode 插件走的是 GitHub REST API 的draft_comments端点，和网页端完全同源。所谓“不一致”，90% 是缓存或状态未刷新导致的视觉误差。
GitHub Actions Secret Exposure Audit
下载
审计 GitHub Actions 工作流文件的密钥泄露风险，例如 pull_request_target 密钥使用、密钥回显命令及未固定版本的 Action 密钥传递。
验证是否真正同步：
- 提交后立即刷新 GitHub PR 网页，检查该行是否出现你的头像+未解决状态的评论
- 在 VSCode 中按
Ctrl+Shift+P运行GitHub Pull Requests: Refresh，强制拉取最新线程 - 如果网页端能看到、VSCode 里看不到，大概率是当前文件没在 PR 的变更列表中（比如你评论的是未被 diff 包含的未暂存文件）
不要依赖插件自动轮询——它默认 30 秒才查一次新回复。高频评审建议手动刷新，或直接切网页端处理长线程讨论。
批注内容能带代码块和截图吗？可以，但得用 Markdown 且限制严格
VSCode 的批注框原生支持 Markdown，但渲染能力比网页端弱：不支持 HTML 标签、不支持 base64 图片、不支持 Mermaid 流程图。
安全可用的富文本写法：
- 内联代码：用单反引号，如
const foo = bar() - 代码块：用三个反引号+语言标识，如
interface Props { ... }（注意换行必须用\n，不能空行） - 截图：只能贴公开可访问链接，如
；本地图片拖入会失败 - @提及：仅支持 GitHub 用户名，如
@alice，但不会触发通知邮件（需网页端提交后才生效）
最易忽略的一点：批注提交后无法再编辑。想改内容，只能删掉重写——网页端可以 edit，VSCode 插件目前不提供编辑入口。
