适用环境

• macOS
• VS Code（Remote SSH）
• OpenAI Codex 插件
• GitHub Copilot（可选）
• 远程 Linux 服务器

---

一、常见故障现象

在日常开发过程中，可能会遇到以下问题：

• Codex 一直加载，无法进入聊天界面
• Codex 页面空白
• VS Code 弹出 The window is not responding
• VS Code 整体卡死、无法点击
• Remote SSH 连接变慢
• VS Code CPU 占用异常

出现这些问题时，不要立即重装 VS Code 或卸载插件，大多数情况下都可以通过简单排查恢复。

---

二、排查原则

遵循以下原则：

✅ 先定位问题，再修改配置。

❌ 不要一开始就：

• 重装 VS Code
• 删除插件
• 删除配置文件
• 重装系统

很多时候只是 VS Code（Electron）的界面渲染出现异常。

---

三、第一步：查看 VS Code 是否真的卡死

如果出现：

The window is not responding

首先打开：

Help
    ↓
Open Process Explorer

重点关注以下几个进程：

Window
Renderer
Extension Host
GPU Process

观察 CPU 占用情况。

情况一：Window（Renderer）CPU 很高

例如：

Window
CPU：100%

甚至

CPU：200%

说明：

VS Code 的界面（Renderer）发生卡顿。

这种情况通常不是代码问题，而是 Electron 渲染层异常。

---

情况二：Extension Host CPU 很高

如果：

Extension Host

CPU 持续很高

说明：

某个插件可能进入死循环。

后续重点排查插件即可。

---

四、查看 Codex WebView 日志

如果 Codex 无法打开，继续检查日志。

打开：

⌘ + Shift + P

输入：

Developer: Open Webview Developer Tools

切换到：

Console

重点关注以下几类错误：

NetworkError

Webview crashed

Renderer crashed

Out of memory

GPU Process

例如本次排查中出现：

NetworkError

https://chatgpt.com/...

说明：Codex WebView 无法正常访问服务器。

---

五、最快恢复方法（优先尝试）

如果 VS Code 没有完全卡死，优先执行：

⌘ + Shift + P

Developer: Reload Window

该命令会重新加载整个 VS Code 窗口。

很多情况下无需重启电脑即可恢复。

这是推荐的第一选择。

---

六、如果仍然卡顿

关闭 VS Code。

打开 Mac Terminal，执行：

open -a "Visual Studio Code" --args --disable-gpu

作用：禁用 VS Code 的 GPU 界面渲染。

很多 Electron 程序（VS Code、Cursor、Discord 等）出现卡顿时，都可以通过此方法验证是否为 GPU 渲染问题。

---

七、不要混淆两种 GPU

很多人容易误解。

这里关闭的是：

Electron GPU

（界面渲染）

不是：

CUDA GPU

（深度学习计算）

因此不会影响：

• Python
• PyTorch
• CUDA
• TensorFlow
• SSH
• Linux 服务器 GPU
• 模型训练

例如：

python train.py

或者：

CUDA_VISIBLE_DEVICES=0 python train.py

训练性能不会受到任何影响。

仅可能影响：

• VS Code 页面滚动
• PDF 渲染
• WebView 动画

属于界面层面的 GPU，而不是计算 GPU。

---

八、检查代理问题（Codex 无法联网时）

如果 DevTools 出现：

NetworkError

可以检查系统代理：

Mac Terminal：

env | grep -i proxy

如果没有任何输出：

说明：

当前 Terminal 没有设置 HTTP/HTTPS Proxy 环境变量。

如果浏览器能够正常访问 ChatGPT，而 VS Code 不行，则需要进一步检查：

• VS Code 是否继承系统代理
• VPN 是否只代理浏览器
• Electron 是否没有走代理

---

九、什么时候需要排查插件

如果只是偶尔一次卡顿：

不建议立即禁用插件。

如果连续几天都出现：

The window is not responding

建议按以下顺序排查：

第一步：

禁用 Codex

↓

观察是否恢复

第二步：

禁用 GitHub Copilot

↓

观察是否恢复

第三步：

检查 Remote SSH

↓

观察是否恢复

最后才考虑：

• 回退 VS Code 版本
• 重装插件

---

十、本次排查记录（2026-07）

本次排查过程中发现：

① Window CPU 曾达到 100%~200%

说明：Renderer 出现卡顿。

---

② DevTools 出现：

NetworkError

说明：Codex WebView 网络请求失败。

---

③ Console 出现：

potential listener LEAK detected

having 527 listeners already

having 615 listeners already

说明：

存在大量重复注册 Listener 的情况。

可能与：

• Electron
• WebView
• 某个插件

有关。

---

④ 执行：

Developer: Reload Window

之后：VS Code 恢复正常。

---

⑤ 使用：

open -a "Visual Studio Code" --args --disable-gpu

重新启动后：

• Codex 恢复正常
• "The window is not responding" 消失
• VS Code 可以正常使用

因此：

目前推测更偏向于：

VS Code（Electron）GPU 渲染或 WebView 状态异常，而不是代码、服务器或 CUDA 环境的问题。

后续继续观察即可。

---

十一、推荐排查流程

以后再次遇到类似问题，可直接按照以下顺序处理：

出现：
"The window is not responding"

        │
        ▼

① Help → Open Process Explorer
        │
        ▼

② 查看 Window / Renderer CPU 是否异常
        │
        ▼

③ 执行
Developer: Reload Window
        │
        ▼

④ 如果仍然卡顿
使用：

open -a "Visual Studio Code" --args --disable-gpu

重新启动
        │
        ▼

⑤ 如果 Codex 无法打开
Developer → Open Webview Developer Tools
查看 Console 日志
        │
        ▼

⑥ 如果连续多天复现
再考虑：

• 禁用 Codex
• 禁用 Copilot
• 回退 VS Code 版本

---

十二、经验总结

经过本次排查，总结出以下经验：

1. 不要因为一次卡顿就重装 VS Code。 很多问题只需要重新加载窗口即可解决。
2. 优先使用 Developer: Reload Window。 这是恢复 VS Code 最快、影响最小的方法。
3. 如果再次发生卡顿，第一时间保存现场。 不要急着重启，先打开 Process Explorer 和 Webview Developer Tools 截图，因为重启后关键日志通常会消失。
4. --disable-gpu 只影响 VS Code 的界面渲染，不会影响 CUDA、PyTorch 或服务器 GPU 的训练性能。

---

一句话总结：

先定位，再处理；先 Reload，再禁 GPU；先观察，再动插件；最后才考虑重装。 这样既能快速恢复工作，也更容易找到问题的真正原因。