“Extension self-check failed”表示GitHub Copilot扩展健康检查失败，需通过命令面板运行GitHub Copilot: Diagnose定位问题，依据[ERROR]信息排查认证、网络等故障，再重启服务、清除缓存或沙箱测试验证修复效果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在VS Code中看到“Extension self-check failed”错误提示，说明GitHub Copilot扩展自身健康检查已失败，无法继续提供代码建议或聊天功能。该错误通常出现在远程开发、插件缓存损坏或认证令牌异常时，需立即执行内置诊断程序定位具体故障点。
触发Copilot内置诊断程序
按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板。
输入 GitHub Copilot: Diagnose，从下拉列表中选择该项并回车执行。
诊断程序会自动运行约8–12秒，期间不可中断，否则将跳过关键检测项。
解读诊断结果中的关键信号
诊断完成后，输出面板会自动切换至 GitHub Copilot Diagnostics 标签页。
重点查找以 [ERROR] 开头的行——这类条目直接对应失效根源，例如：[ERROR] AuthError: Missing token scopes: 'copilot' 表示远程服务器上缺失Copilot专属权限令牌；[ERROR] Network: Failed to connect to https://api.githubcopilot.com 表明网络层已被拦截或代理配置错误。
若出现 [INFO] All checks passed，但Copilot仍不工作，说明问题出在UI层或编辑器状态，需跳转至「重置扩展上下文」步骤。
重置扩展上下文（强制刷新运行环境）
方法一：重启Copilot服务进程
在命令面板中执行 GitHub Copilot: Restart Server，等待右下角通知显示“Copilot server restarted successfully”。
方法二：清除本地运行时缓存
关闭VS Code → 在终端中执行：rm -rf ~/.vscode/extensions/github.copilot-*rm -rf ~/.config/github-copilot/
【注意：此操作将删除所有本地认证凭证，需重新登录】
方法三：启动隔离沙箱环境验证
终端执行：code --user-data-dir ~/tmp-copilot-test --extensions-dir ~/tmp-copilot-exts
仅安装Copilot扩展后测试，可排除其他插件干扰。
验证诊断修复是否生效
第一步：确认状态栏图标变为实心蓝色且无斜杠划线。
第二步：新建一个 .py 文件，输入 def hello(): 后按 Enter，观察是否弹出建议补全气泡。
第三步：按下 Ctrl+Enter（Windows/Linux）或 Cmd+Enter（macOS）唤起Copilot Chat，输入“test”并发送，确认响应正常。
