GitHub PR面板不显示需满足三条件：打开正确仓库根目录、远程origin指向GitHub、已登录授权；创建PR可在编辑器内完成；文件打不开多因路径不匹配；CI不同步常因Token限流或未配置企业版URL。
为什么 GitHub Pull Requests and Issues 插件装了却看不到 PR 面板？
插件本身不自动激活 PR 视图，必须先打开一个已关联 GitHub 仓库的文件夹，且该仓库需有远程 origin 指向 GitHub（而非 GitLab 或自建 Gitee）。如果仓库是本地初始化后才 `git remote add` 的，VSCode 可能缓存了旧状态——关掉窗口，用 code /path/to/repo 重新打开，比在 VSCode 内“重新打开文件夹”更可靠。
常见错误现象：Cannot load pull requests: No GitHub repository found。检查点包括：
-
git remote -v输出中必须含github.com域名，且协议为https或git@（SSH） - 仓库根目录下不能存在
.git的上级嵌套（比如打开的是子模块路径，而非主仓库根） - 插件要求登录 GitHub 账号：点击侧边栏 GitHub 图标 → “Sign in to GitHub” → 用 Token 或浏览器授权（推荐用 Personal Access Token，勾选
repo和workflow权限）
如何快速创建 PR 而不离开 VSCode？
不需要切到浏览器写标题、填描述、选 base 分支——所有操作都在编辑器内完成。
步骤如下：
- 确保当前分支已 commit 并 push 到远程（插件不会帮你 push）
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入GitHub Pull Requests: Create Pull Request - 选择目标分支（默认是
main或master，可手动编辑） - 在弹出的编辑器中填写
Title和Description，支持 Markdown；保存即提交 PR - 创建后，左侧 GitHub 视图会自动展开 PR 列表，当前 PR 显示为“Draft”或“Open”，点进去可看 diff、评论、状态检查
注意：Description 编辑框里粘贴长文本可能卡顿，建议先在外部写好再粘贴；若提交失败，错误信息通常提示 Validation Failed: The base branch has changed，说明目标分支已有新 commit，需先 rebase 或 merge。
GitHub Pull Requests 面板里点文件打不开？
这是权限和路径映射问题，不是插件 bug。PR 面板中的文件列表点击后，VSCode 尝试用本地工作区路径匹配远程 diff 路径。如果本地文件已被重命名、移动，或 PR 修改的是 submodule 内容，就会显示 File not found in workspace。
实操建议：
- 确认你打开的工作区就是该 PR 所属仓库的根目录（不是父目录或子目录）
- 避免在 PR 创建后，在本地执行
git checkout切换分支——插件依赖当前HEAD所在分支与 PR 的关联性 - 对未跟踪的新文件（
new file mode），点击后会打开空编辑器；此时需手动Ctrl+K Ctrl+O打开文件对话框，定位到对应路径再保存 - 如需对比修改前后的版本，右键文件 → “Compare Against Base” —— 这个功能比双击更稳定
CI 状态不刷新、评论不实时同步怎么办？
插件默认每 60 秒轮询一次 GitHub API，但网络策略、Token 权限或企业防火墙可能导致延迟或失败。不刷新 ≠ 功能失效，而是同步机制被阻断。
排查优先级：
- 检查 GitHub 账号是否仍在线：侧边栏 GitHub 图标右下角应有绿色小点；若变灰，点击重登
- 打开 VSCode 设置，搜索
github pull requests refresh，确认githubPullRequests.refreshInterval未被设为0（禁用刷新） - 终端运行
curl -H "Authorization: token YOUR_TOKEN" https://api.github.com/rate_limit，看rate中remaining是否为 0（Token 被限流） - 企业用户注意：GitHub Enterprise Server 需在设置中填写
githubPullRequests.githubServerUrl，且值必须带https://前缀，末尾不加/api/v3
实时性要求高的场景（如等待 CI 通过后合并），别只盯插件面板——它不替代 gh pr status 或网页通知。真正关键的状态变更（如 Checks completed、Review approved），插件只做轻量同步，底层仍依赖 GitHub Webhook 推送，而本地插件无权接收 Webhook。
