vscode大纲视图空白或无响应，首要排查语言模式是否正确、语言服务器是否就绪、折叠功能是否启用及插件冲突。需依次检查右下角语言标识、output面板日志、editor.folding设置，并用code --disable-extensions或扩展二分法定位问题。
大纲视图空白或点击无反应，先确认语言支持是否就位
VSCode 的大纲（Outline）视图不显示符号、无法展开层级，最常见原因是当前文件没被识别为受支持的语言类型。比如打开一个 .ts 文件但右下角显示的是 Plain Text，或者 .py 文件没触发 Pylance 语言服务器——此时大纲根本不会生成，不是“展不开”，是“没得展”。
检查步骤：
- 看右下角语言模式，点击后手动选
TypeScript、Python等对应项； - 按
Ctrl+Shift+P运行Developer: Toggle Developer Tools，切到Console标签页，搜outline或language server，看是否有初始化失败报错； - 在
Output面板中切换到对应语言的输出通道（如Python、JavaScript），观察是否卡在“Starting language server…”或报错Failed to start language server。
已识别语言但大纲仍为空，重点查语言服务器状态
即使文件语言模式正确，大纲依赖的语言服务器（LSP）若未就绪或崩溃，也会导致视图空着。例如 ms-python.python 插件未加载成功，或 rust-analyzer 卡在初始化阶段，大纲就永远是空的。
实操建议：
- 运行命令
Developer: Restart Language Server（部分语言支持该命令）； - 在
Output面板中查看对应语言日志，重点关注stderr输出或connection closed类提示； - 临时禁用该语言插件（如禁用
Pylance后启用原生Python扩展），测试是否恢复基础大纲能力； - 注意：某些语言（如 Go、Rust）要求工作区根目录存在
go.mod或Cargo.toml才启动 LSP，否则大纲不触发。
大纲能显示但无法展开嵌套节点，检查折叠策略与配置冲突
大纲视图中的符号可点击展开子层级，但点不动时，往往不是插件问题，而是 VSCode 折叠引擎未启用或被覆盖。大纲的展开行为底层复用编辑器的折叠逻辑，如果 "editor.folding": false 或 "editor.foldingStrategy": "indentation"，会导致大纲节点失去交互能力。
关键验证点：
- 打开设置 JSON（
Preferences: Open Settings (JSON)），确认没有显式关闭折叠："editor.folding": true； - 避免设成
"indentation"—— HTML/JSON/TS 等结构化语言必须用"syntax"才支持基于标签/大括号的智能折叠； - 某些插件（如
Auto Fold）会劫持折叠行为，若大纲展开异常，可临时禁用它测试； - 大纲节点本身不响应点击，但按
Ctrl+K Ctrl+J（展开所有折叠）后，再点大纲里的函数名，有时能触发跳转——说明折叠系统正常，只是大纲 UI 层级联动失效。
插件冲突导致大纲完全消失，用二分法快速定位
当大纲视图整个不出现（连标题栏都看不到），且语言和 LSP 均正常，大概率是某个插件覆盖了大纲视图注册逻辑，或通过 API 注入了错误的 TreeDataProvider。这类问题不会报错，只会静默屏蔽。
高效排查方式：
- 终端执行
code --disable-extensions启动，若大纲立刻出现，100% 是插件引起； - 按
Ctrl+Shift+P运行Developer: Start Extension Bisect，回答几次“是否看到大纲”即可锁定问题插件； - 重点关注近期更新或安装的插件，尤其是带“outline”、“symbols”、“tree”字样的扩展（如
vscode-icons、Project Manager、自定义主题类插件）； - 禁用后仍不恢复？检查
settings.json中是否有"outline.showHidden": false或"outline.symbols": false这类隐藏开关被误设。
Output 面板里对应语言通道有没有输出。
