vscode html大纲为空是因为内置html模式不提供documentsymbolprovider，仅支持语法高亮；需改用html(ejs)语言模式或安装tree-sitter扩展并配置tree-sitter-html解析器。
VSCode 的大纲（Outline）视图默认不常驻，且对语言支持有明确依赖——不是所有文件都能显示结构树，也不是装了插件就自动生效。
为什么打开 .html 文件大纲是空的
HTML 文件的大纲为空，不是配置错误，而是 VSCode 内置 html 语言模式压根不提供 DocumentSymbolProvider。它只做语法高亮和基础标签匹配，不解析 DOM 层级为符号。即使你看到 <div> 嵌套再深，也不会变成大纲里的可折叠节点。
<ul>
<li>右下角显示 “HTML” ≠ 符号已就绪；它只是告诉编辑器用哪套高亮规则</li>
<li>
<code>Auto Rename Tag、Path Intellisense 这类插件完全不影响大纲数据输出
HTML (EJS)）或安装支持符号提取的扩展（如 emeraldwalk.vscode-tree-sitter + tree-sitter-html）Python / TypeScript / Rust 等语言大纲为空怎么办
这类语言大纲空白，基本可锁定为语言服务器未启动或未识别文件类型。重点检查三件事：
- 右下角语言模式是否正确？比如
.py文件显示 “Plain Text”，点击后手动选 “Python” - 对应扩展是否启用？Python 必须装
ms-python.python或ms-python.pylance；Rust 必须用rust-analyzer（官方推荐，旧版Rust扩展已弃用） - 是否保存了文件？部分语言服务（如 TypeScript）只对已保存的文件触发符号提取 → 先按
Ctrl+S
若仍卡在 “Loading…”，打开命令面板（Ctrl+Shift+P），运行 Developer: Restart Language Server 强制刷新。
如何真正打开并固定大纲面板
大纲默认不显示在侧边栏，需主动唤出并拖拽固定：
- 快捷键：
Ctrl+Shift+O（Windows/Linux）或Cmd+Shift+O（macOS）→ 弹出浮动符号面板 - 要让它常驻左侧边栏：点击左下角“大纲”图标（书本形状），或右键活动栏 → “显示大纲视图”
- 首次打开后，直接拖动该面板标题栏到左侧边栏顶部/底部，它会自动吸附固定
- 若误拖成浮动窗口，右键面板标题 → “Move into Activity Bar” 即可拉回
符号显示不全或层级缺失的常见原因
即使大纲出来了，也可能只显示类名、不展开方法，或漏掉嵌套函数——这不是 bug，而是语言服务器实现粒度不同：
- TypeScript 默认不显示
useEffect这类 Hook，因为eslint-plugin-react不提供DocumentSymbol数据 - Rust 的
rust-analyzer默认只展开impl块内的方法，顶层自由函数能显示，但不会把match分支当子节点 - 大文件（>5000 行）可能被截断，可在设置中调高
editor.symbolDisplayLimit（默认 100） - 检查设置项：
outline.showFunctions、outline.showClasses是否为true；某些扩展（如PHP Intelephense）还需单独开启intelephense.editor.outline
最易被忽略的一点：大纲依赖的是 AST 解析结果，不是文本正则匹配。哪怕你写了个看似函数的 def foo():，如果缩进错、冒号漏、或被注释包裹，它就不会进符号树——这点和折叠功能完全不同。
