Win10 WSL2 环境下 VS Code Copilot 连接失败排查与修复

问题描述

在 Win10 搭配 WSL2 的远程开发环境中，VS Code 的 Copilot Chat 功能经常无法正常初始化。具体表现为：

Chat 启动后卡在初始化流程，等待一段时间后提示 Retry Connection。如果尝试重载窗口（Reload Window），则会报错："Chat took too long to get ready. Please ensure you are signed in to GitHub and that the extension GitHub.copilot-chat is installed and enabled."。

解决方案

根据社区反馈及实际排查经验，这个问题通常由插件版本兼容性或网络代理配置冲突引起。建议按以下顺序处理。

回退 Copilot 版本

当前最新版本的 Copilot 插件在某些 WSL2 环境下存在稳定性问题。参考社区讨论，将插件回退至 v1.252.0 版本往往能直接解决问题。

操作步骤：

1. 打开 VS Code 扩展面板，找到 Copilot 插件。
2. 点击卸载按钮旁边的下拉箭头，选择 "Install Specific Version"。
3. 在列表中选择 v1.252.0 进行安装。

安装完成后，记得关闭自动更新功能，防止插件再次升级导致问题复现。

检查网络代理配置

有时候即使回退了版本仍然无法使用，这通常是因为之前的调试操作误改了网络代理设置。我们需要确认 VS Code 是否错误地调用了本地代理。

验证方法： 在 VS Code 控制台（Terminal -> Output），将视图切换为 "Copilot"，查看日志输出。如果看到类似 127.0.0.1:7890 或 127.0.0.1:7987 的连接记录且显示不通过，说明是代理拦截了请求。

清理步骤：

1. 进入设置页面（Settings），确保当前上下文为 Remote [WSL:Ubuntu]。
2. 搜索 proxy，取消勾选 Http: Proxy 选项。

3. 同时关闭 Http: Use Local Proxy Configuration。

完成上述设置后，重新 Reload Window。观察控制台日志，若不再出现代理连接失败的报错，即可正常使用。