不少开发者在使用 GitHub Copilot 时都遇到过“Token refresh failed”报错，光标旁突然不再出现代码建议，状态栏显示未登录，甚至反复弹出授权失败提示。这其实并非什么玄学 bug，问题通常出在本地认证令牌过期或损坏。解决方法也很直白：先确认当前账号没有混淆，再执行一套“三步强制注销”操作，最后重新走一遍完整的 OAuth 授权流程。
简单说，本地 token 失效后，必须让 Copilot 彻底忘掉旧的缓存，重新完成身份识别。
确认当前登录状态与账户一致性
先别急着清理缓存，第一步是核实当前登录的 GitHub 账户是否正确。点击 VS Code 左下角的账号图标，检查显示的邮箱是否与你订阅 Copilot 的 GitHub 账户完全一致。注意：个人版与企业版不能混用，邮箱后缀及 SSO 绑定的域名都必须匹配。如果账号图标显示“Sign in to use GitHub Copilot”或者邮箱明显有误，直接跳到下一步；如果邮箱正确但仍报 Token 错误，说明本地的 token 缓存已过期，必须强制清除。
执行三步强制注销
第一步：在 VS Code 中按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板，输入并执行 GitHub Copilot: Sign Out，确认登出——此时状态栏上的 Copilot 图标会变灰。
第二步：关闭所有 VS Code 窗口，包括远程 SSH 会话，确保进程完全退出。这一步容易被忽略，但残留的后台进程会锁住 token 缓存文件，导致后续的重装或重新登录全部无效。
第三步？实际上前两步已经完成注销，但还需要清除冗余的认证数据，这部分单独作为下一节。
清除残余认证数据
方法一（推荐）：手动删除本地的 token 缓存目录。
- Windows：删除
%USERPROFILE%\.vscode\extensions\github.copilot-*下所有以 copilot 开头的文件夹； - macOS：删除
~/Library/Application Support/Code/Extensions/github.copilot-*； - Linux：删除
~/.vscode/extensions/github.copilot-*。
【删除前请确认 VS Code 已完全关闭，否则文件可能被占用无法删除】
方法二：同步清除系统级凭据。
- Windows用户：打开“Windows凭据管理器” → “普通凭据” → 删除所有包含
github或copilot的条目； - macOS用户：在终端运行命令
security find-internet-password -s github.com | grep -q "copilot" && security delete-internet-password -s github.com（如果报错忽略即可，仅清理已存在的项）。
触发全新 OAuth 授权流程
完成上述清理后，重新启动 VS Code，按下 Ctrl+Shift+P 打开命令面板，输入并选择 GitHub: Sign In——注意：必须使用 GitHub 主扩展的入口，而非 Copilot 相关的命令。按照提示在浏览器中完成授权。关键点：浏览器跳转后，务必在 GitHub 页面上点击“Authorize GitHub”按钮，不能只关闭页面；授权完成后，浏览器会自动跳回 VS Code 并加载 Copilot 状态。
如果卡在空白页，或者遇到报错 Unable to open 'Copilot': Cannot read properties of undefined (reading 'code')，请立即中断流程，返回上一步彻底清空缓存再重试。这一步没有妥协余地。