跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言VScodeAI

排查 VSCode Copilot 的未知工具警告

VSCode Copilot 的 agent 配置里出现“未知工具”警告，通常不是配置文件损坏，而是引用了当前环境未注册的工具。`github.vscode-pull-request-github/...` 这类提示多半是没安装 GitHub Pull Requests 扩展，装上即可；`github/issue_read` 则属于 Copilot 内置工具链相关问题，VSCode 1.113 之后有已知异常，删文件也会重建，只能等待官方修复。

CryptoLab发布于 2026/6/30更新于 2026/10/1761 浏览

排查 VSCode Copilot 的未知工具警告

VSCode Copilot 配置警告截图

在 VSCode 里打开 Copilot 的 agent 配置时，我遇到过一组挺烦人的诊断警告：文件删掉会自己重建，警告也跟着回来。第一反应很容易把它当成 bug，但这事要先分清楚到底是'配置坏了'，还是'某些工具根本没装'。

[
  {
    "resource": "/d:/.vscode/User/globalStorage/github.copilot-chat/ask-agent/Ask.agent.md",
    "owner": "prompts-diagnostics-provider",
    "severity": 4,
    "message": "未知工具'github/issue_read'。"
  },
  {
    "resource": "/d:/.vscode/User/globalStorage/github.copilot-chat/ask-agent/Ask.agent.md",
    "owner": "prompts-diagnostics-provider",
    "severity": 4,
    "message": "未知工具'github.vscode-pull-request-github/issue_fetch'。"
  },
  {
    "resource":
"/d:/.vscode/User/globalStorage/github.copilot-chat/ask-agent/Ask.agent.md"
,
"owner"
:
"prompts-diagnostics-provider"
,
"severity"
:
4
,
"message"
:
"未知工具'github.vscode-pull-request-github/activePullRequest'。"
}
]

这类警告通常怎么来的

这类提示本身不算异常。Copilot 的预置 agent 会引用一些可选工具，而这些工具只有在对应扩展安装后才会被 VSCode 识别。

未知工具需要的扩展
github/issue_readGitHub 相关扩展
github.vscode-pull-request-github/issue_fetchGitHub Pull Requests 扩展
github.vscode-pull-request-github/activePullRequestGitHub Pull Requests 扩展

Ask.agent.md 是 Copilot 自带的 agent 配置文件，里面直接写了这些工具名。你如果没装 GitHub Pull Requests and Issues，VSCode 就会把它们当成'未知工具'。这时候报的是诊断警告，不是运行时错误。

怎么处理

装上缺失扩展

如果你本来就会用 GitHub PR / Issue 相关能力，直接装扩展最省事：

  • GitHub Pull Requests
  • 扩展 ID：github.vscode-pull-request-github

不处理也可以

severity 4 是 Warning。它看着碍眼，但一般不影响 Copilot 正常使用。只要你不依赖这些工具，完全可以先放着。

要不要专门反馈

如果你看到的是 github.vscode-pull-request-github/... 这两项，通常不用单独报问题，原因比较明确：扩展没装齐。

github/issue_read 这项更麻烦一点，它来自 Copilot 内置工具链，不是简单补一个扩展就能解决。这个问题在 VSCode 1.113 之后确实有不少人碰到，表现是内置 agent 文件引用了工具，但当前环境里没有对应注册项，所以每次重建配置后都会继续报。

这部分就只能等官方修复了。手动删文件没意义，它会被 Copilot 再生成回来。

结论

这个警告有两种情况：

  • 需要的扩展没装，补扩展就行
  • github/issue_read 这类内置工具引用异常，只能等官方补丁

它不会直接把 Copilot 弄坏。真正该在意的不是这条告警本身，而是它到底指向'缺扩展'，还是'内置工具注册出了问题'。前者很好处理，后者只能等版本更新。

目录

  1. 排查 VSCode Copilot 的未知工具警告
  2. 这类警告通常怎么来的
  3. 怎么处理
  4. 装上缺失扩展
  5. 不处理也可以
  6. 要不要专门反馈
  7. 结论

更多推荐文章

查看全部
  • AI、AGI、AIGC、NLP、LLM 与 ChatGPT 的核心区别与联系
  • Microsoft Edge WebView2 Runtime 快速部署与调试指南
  • Ubuntu 22.04 源码编译安装 CARLA 0.9.15 教程
  • 数据结构基础：二叉树与堆的实现详解
  • OpenClaw 在 Ubuntu 20.04 下的安装及 CMake 版本错误解决方案
  • Mac 下使用 LLaMA Factory 微调模型并导入 Ollama 实践
  • 动态规划入门：线性 DP 四道经典题解析
  • 安卓手机通过 Termux 和 Alpine 部署 Docker 并实现外网访问
  • 用 Obsidian.nvim 在 Neovim 里复刻 Obsidian 工作流
  • PyApp：将 Python 工程打包为可执行文件的简易方法
  • Linux 构建工具核心：make 命令、进度条与 Gitee 使用
  • OpenClaw 与 Telegram 机器人集成指南
  • 基于 SpringBoot 与 Vue 的流浪宠物管理系统设计与实现
  • OpenClaw 实操指南：Claude Code 本地部署与飞书集成
  • Llama3-8B 一键部署教程：vllm+Open-WebUI 镜像免配置
  • GitHub Copilot 高效编程实战指南：从配置到高级技巧
  • 钉钉 Webhook 机器人配置与 @ 用户实现指南
  • C++ 智能指针原理与实现
  • 通义万相 2.1 文生图技术部署与异构算力应用解析
  • PyCharm 编写 Python 程序完整教程

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online

  • Markdown转HTML

    将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online