VSCode Copilot 在 Win10 WSL2 环境下无法使用的排查与修复

问题表现

在 Win10 搭配 WSL2 的环境下运行 VSCode 时，Copilot 的 Chat 功能经常无法正常启动。具体表现为点击聊天入口后，界面长时间停留在初始化状态，随后弹出'重试连接'的提示。如果强制重载窗口，通常会收到如下报错：

再次尝试时会直接报错：'等待 Chat 就绪时间过长。请确保已登录 GitHub 且 GitHub.copilot-chat 扩展已安装并启用。'

解决方案

1. 回退插件版本

社区中有不少开发者反馈，最新版本的 Copilot 在特定环境下存在兼容性问题。可以尝试将插件回退到 v1.252.0 版本，这通常能解决大部分初始化挂起的问题。

操作步骤如下：

1. 打开 VSCode 插件市场，找到 Copilot。
2. 点击卸载按钮旁边的下拉菜单，选择'安装特定版本'。
3. 在列表中选择 v1.252.0 进行安装。

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

2. 排查网络代理

有时候即使版本回退成功，如果网络代理配置不当，依然会导致连接失败。特别是在 WSL2 环境中，VSCode 可能会继承错误的代理设置。

首先查看 VSCode 控制台的日志。切换到 Output 面板，搜索 Copilot。如果看到类似 127.0.0.1:7890 或 127.0.0.1:7987 的连接拒绝记录，说明是代理问题。

解决方法是关闭 VSCode 内部的代理设置：

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

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

完成上述设置后，重新加载窗口。此时观察控制台日志，如果不再出现代理连接错误，说明问题已解决。