live server未刷新需先确认是否启动：若状态栏无“live server: 5500”提示，则服务未运行，常见原因包括缺失根目录index.html、body被注释导致脚本注入失败、或路径配置错误。
Live Server 面板不刷新，先看它到底启没启动
“点了 Go Live 没反应”不是刷新问题，是服务压根没跑起来。VS Code 状态栏右下角不显示 Live Server: 5500，就别调刷新逻辑了。
常见卡点：
-
index.html缺失或不在当前工作区根目录——Live Server 只认根目录下的index.html，不扫描子目录，也不 fallback 到main.html等文件 -
body标签被整段注释（<!-- <body>...</body> -->）——注入 WebSocket 刷新脚本失败，页面就只能手动 F5 - 状态栏没提示，但右键 HTML 文件选
Open with Live Server能打开——说明服务可运行，只是根路径变了，相对资源引用可能出错
Codex / Chat 插件面板卡在加载页，重点查进程与日志层
终端里 Codex 能用 ≠ VS Code 插件能用。它们启动入口、进程隔离、UI 渲染上下文完全不同。
真实排查顺序应该是：
- 按
Ctrl+Shift+P输入Developer: Toggle Developer Tools，切到 Console 面板，看有没有ERR或Failed to load类报错 - 检查插件输出面板：
View → Output→ 左上角下拉选Codex或对应插件名，看是否卡在 “Starting server…” 或报soft nofile: 1024（Ubuntu 默认文件描述符限制太低） - 确认插件进程是否真在运行：
ps aux | grep codex或htop查找相关 node 进程；若无，说明扩展未完成初始化，不是 UI 渲染慢，而是根本没活起来
预览类面板（如 Markdown Preview）不随编辑更新，盯住三个监听环节
VS Code 的预览刷新不是“改完就刷”，它依赖三层事件链对齐：文件系统变更 → 编辑器文档保存状态 → WebView 活跃性。任一环断开，就静止不动。
高频失灵组合：
- 启用了
"markdown.preview.autoshowpreviewtoside": true，但预览窗口被拖成独立标签页——此时它脱离 active editor group，ondidchangetextdocument不再触发 - 外部工具（如
rsync、GitLens 历史查看、Obsidian 同步器）直接覆写.md文件，VS Code 的chokidar监听未捕获 fs 事件（尤其在 WSL 或 NFS 挂载路径下） -
"files.autosave"实际为"off"（被工作区设置覆盖），而预览只响应「已保存」的文档变更，编辑中内容不会触发刷新
所有面板共性卡点：缓存损坏与高 DPI 坐标漂移
当多个插件面板同时出现“空白”“停在 logo”“缩成一条线”等现象，大概率不是插件本身问题，而是 VS Code 渲染层缓存或布局快照损坏。
必须清的两个目录（清完需彻底退出 VS Code 再重启）：
-
Backups：存窗口尺寸、折叠状态、面板可见性快照。Windows 路径为%APPDATA%\Code\Backups，Linux/macOS 对应~/.config/Code/Backups或~/Library/Application Support/Code/Backups -
Cache：存渲染上下文和 WebView 初始化数据。Linux/macOS 路径为~/.cache/Code，Windows 为%APPDATA%\Code\Cache
特别注意多显示器 + 高 DPI 场景：VS Code 实际渲染坐标可能偏移出屏幕可视区域，侧边栏“消失”其实是真在屏幕外——这时候光清缓存不够，还得同步检查系统缩放设置和 window.zoomLevel 是否冲突。
