若 VSCode 中 GitHub Copilot Chat 无法启动、响应延迟或显示“未启用”,需依次检查扩展安装与启用状态、GitHub 账户登录及订阅状态、重置本地服务缓存、切换后端连接模式。

如果您在使用 VSCode 的 GitHub Copilot Chat 功能时无法正常启动对话、接收响应延迟或提示“未启用”状态,则可能是由于扩展未正确配置、账户权限受限或本地服务未就绪。以下是解决此问题的步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、检查 Copilot 扩展安装与启用状态
GitHub Copilot Chat 依赖于官方 Copilot 扩展提供底层服务,若扩展未安装、被禁用或版本过旧,将导致 Chat 界面不可用或功能缺失。
1、打开 VSCode,点击左侧活动栏中的扩展图标(方块拼图形状)。
2、在扩展搜索框中输入 GitHub Copilot,确认已安装官方出品的扩展(发布者为 GitHub)。
3、若右侧显示“已禁用”,点击“启用”按钮;若显示“更新”,先执行更新操作。
4、重启 VSCode,再次尝试通过 Command+Shift+P(macOS)调出命令面板,输入 Copilot: Open Chat 并执行。
二、验证 GitHub 账户登录与订阅状态
Copilot Chat 需要有效的 GitHub 账户授权及活跃的 Copilot 订阅(个人免费试用期已结束的用户需确认是否续订),未登录或权限异常将直接阻止 Chat 初始化。
1、点击 VSCode 左下角账户图标(通常显示头像或用户首字母)。
2、确认当前登录账户为已绑定 Copilot 的 GitHub 账户;若未登录,选择“Sign in to GitHub”并完成 OAuth 授权流程。
3、访问 https://github.com/settings/copilot,确认账户页面显示“Copilot is active”且无订阅中断提示。
4、返回 VSCode,在命令面板中再次运行 Copilot: Sign in,确保认证令牌刷新成功。
三、重置 Copilot 本地服务缓存
Copilot Chat 后台服务(copilot-agent)可能因缓存损坏或端口占用而停滞,强制重置可恢复通信链路。
1、关闭所有 VSCode 窗口,包括后台进程(macOS 可在活动监视器中搜索 copilot-agent 并强制退出)。
2、打开终端,执行命令:rm -rf ~/.vscode/extensions/github.copilot-chat-*,清除旧版 Chat 相关缓存目录。
3、重新打开 VSCode,等待扩展自动重装 Copilot Chat 子模块(状态栏右下角会短暂显示“Initializing Copilot…”)。
4、再次调用 Copilot: Open Chat,观察是否出现空白对话窗口或加载指示器。
四、切换 Copilot Chat 后端连接模式
默认情况下 Copilot Chat 使用云端模型服务,但在某些网络环境下可能因 DNS 解析失败或代理策略拦截而超时;切换至本地代理或直连模式可绕过中间节点限制。
1、按下 Command+Shift+P 打开命令面板,输入并选择 Preferences: Open Settings (JSON)。
2、在 settings.json 文件中添加如下配置项:
"github.copilot.chat.backend": "cloud"(默认值,适用于多数场景)
或
"github.copilot.chat.backend": "local"(仅当本地运行了兼容的 Copilot Agent 实例时启用)
3、保存文件后,关闭并重新打开 VSCode 窗口。
4、使用快捷键 Option+Command+I(macOS)唤起 Copilot Chat 输入框,测试响应速度与内容生成完整性。











