VS Code Codex 侧边栏对话超时？排查与解决指南

VS Code Codex 侧边栏对话超时？排查与解决指南

最近有不少朋友在群里反馈，在使用 VS Code 的 Codex 扩展时，侧边栏突然“罢工”了，不管是提问还是生成代码，直接提示“Timeout”或者请求超时。本来正写代码写得兴起，突然来这么一下，真的很搞心态。

如果你也遇到了这个问题，别急着卸载重装，先按下面的步骤一步步排查，80% 的情况都能自己搞定。

Codex 无论是使用官方版还是国内魔改版，本质上都需要调用远程的 AI 服务接口。如果你的网络环境无法稳定连接到服务器，超时是必然的。

代理设置检查：如果你开了全局代理，VS Code 不一定继承系统代理。请检查 VS Code 的 settings.json，确保配置了正确的 http.proxy 参数。或者，尝试直接在终端里 curl 一下接口地址，看看能否连通。
防火墙/安全软件拦截：有时候公司的内网防火墙或者本地的杀毒软件会拦截未知的对外请求。试着暂时退出这些软件再试一次。
DNS 污染：这是一个隐形成本。有时候 API 域名解析到了错误的 IP，导致连接超时。可以尝试修改本地 DNS 为 8.8.8.8 或 1.1.1.1，或者修改 Hosts 文件强制解析正确的 IP。

很多超时问题其实是配置不当导致的“假”超时。

API Key 路径问题：如果你使用的是需要自定义 API Key 的版本，请检查 Key 是否填写正确，或者 Token 是否已经过期。有时候 Key 错了一个字符，服务器一直在验证，直到超时也不会报具体错误。
Base URL 设置：确保插件的 Base URL 地址是完全正确的。有些服务端可能会更换域名或者端口，如果你还在用旧的配置，请求发出去自然是石沉大海。
模型选择：有些冷门模型可能负载较高或者正在维护，尝试切换到其他模型（如 GPT-3.5 或 GPT-4）测试一下是否能连通。

如果上面两步都没问题，那就需要进阶一点了。VS Code 自带开发者工具，里面藏着所有后端的小秘密。

打开方式：在 VS Code 中按下 Ctrl + Shift + P（Mac 是 Cmd + Shift + P），输入 Developer: Toggle Developer Tools 并回车。
查看 Network 面板：切换到 Network 标签页，然后再次在侧边栏尝试发送一条指令。
- 如果看到请求状态是 Pending 了很久变成红色，那是网络连接问题。
- 如果看到 401 Unauthorized，那是 Key 或鉴权问题。
- 如果看到 500 或 502 错误，那是服务器那边炸了，你只能等或者换服务。
Console 报错：切到 Console 标签，看看有没有红色的报错信息。有时候插件本身的 Bug 会在这一脚露馅，记录下报错信息去搜一下，往往能找到同病相怜的人。

如果日志里也没看出个所以然，那可能是本地缓存坏掉了。

清除插件缓存：完全禁用 Codex 插件，手动删除用户目录下 .vscode/extensions 中对应的插件文件夹，然后重新安装。
重启 VS Code：老生常谈，但很多时候 VS Code 的主进程卡死会导致所有子请求挂起。把 VS Code 彻底关掉（任务管理器里看一眼是不是还有残留进程），再重新打开。

遇到侧边栏对话超时，大概率是网络或者配置的问题，而不是代码写崩了。先测网络，再看配置，最后看日志。只要不是服务器集体宕机，按照上面的流程排查下来，基本都能恢复正常的开发体验。

希望大家都能写得开心，不再被超时困扰！