VSCode Copilot 配置文件提示警告处理
最近在使用 VSCode 配合 Copilot 时,可能会在配置文件中遇到一些诊断警告。特别是涉及 GitHub 相关工具调用时,系统会提示'未知工具'。这通常不是严重错误,但确实影响体验。下面梳理了常见原因及解决方案。
现象描述
打开 .vscode/User/globalStorage/github.copilot-chat/ask-agent/Ask.agent.md 相关文件时,诊断面板可能显示如下信息:
{
"resource": "/d:/.vscode/User/globalStorage/github.copilot-chat/ask-agent/Ask.agent.md",
"owner": "prompts-diagnostics-provider",
"severity": 4,
"message": "未知工具 'github/issue_read'。",
"startLineNumber": 7,
"startColumn": 51,
"endLineNumber": 7,
"endColumn": 70
}
这类警告通常指向 github.vscode-pull-request-github 相关的工具未注册或扩展缺失。
原因分析
出现此类警告主要有两种情况:
1. 缺少对应扩展(最常见)
Copilot 的 Agent 配置引用了一些特定工具,这些工具依赖于第三方扩展才能被识别。如果未安装对应的 GitHub 扩展,VSCode 就无法找到这些工具定义。
| 报错工具 | 需要安装的扩展 |
|---|---|
github/issue_read | GitHub 相关扩展 |

