VSCode Outline 面板为空的主因是语言支持缺失、设置未启用或文档结构不规范；需确保语言模式正确、开启 explorer.experimental.showOutline 和对应语言服务器就绪。
VSCode 的 Outline 视图不是“开了就能用”的功能，它依赖语言支持、正确配置和文档结构三者协同——缺一不可。很多用户点开 Outline 面板却看到空白，问题通常不出在面板本身，而在于当前文件没被识别为可解析的代码/文档类型，或关键设置被禁用。
Outline 面板为什么是空的？
常见现象：Outline 面板显示“No symbols found in document”或完全不渲染任何节点。
- 当前文件未启用对应语言模式（如
.rs文件未被识别为 Rust，.py文件未激活 Pylance） -
explorer.experimental.showOutline设置为false（VSCode 1.85+ 默认关闭该实验性选项） - 语言服务器（如
rust-analyzer、Pylance）未就绪：左下角显示 “Loading…” 或报错Language server is not ready - Markdown 文件中标题未用标准 ATX 格式（例如写成
* 一级标题或缩进式标题，Outline 不识别）
如何让 .md 文件显示大纲？
VSCode 内置支持 Markdown 大纲，但需手动开启两个关键开关：
- 打开设置（
Ctrl + ,），搜索explorer.experimental.showOutline，勾选启用 - 同时搜索
markdown.preview.toc，设为true（影响预览页内 TOC，也间接增强 Outline 解析稳定性） - 确保文件后缀是
.md，且标题使用纯#开头，例如：# 标题、## 子标题，不能混用空格或制表符干扰解析 - 如果仍不显示，右键编辑器标签 → “Reopen with Language Mode” → 明确选
Markdown
如何让 .rs / .py / .ts 等代码文件显示大纲？
这类文件的大纲能力完全由语言服务器提供，不是 VSCode 自身解析的：
- Rust：必须安装并启用
rust-analyzer；首次打开项目时等待左下角提示消失（“Rust Analyzer is loading…”） - Python：推荐
Pylance（非 Python 官方插件）；若大纲为空，尝试切换至 Pre-Release 版本或重装 - TypeScript/JavaScript：内置支持，但需确保文件在
tsconfig.json或jsconfig.json项目范围内，否则符号提取失效 - 所有语言：按
Ctrl + Shift + P输入Developer: Toggle Developer Tools，查看 Console 是否有Failed to resolve document symbols类报错
Outline 面板点击不跳转？
能显示但点击无反应，说明符号位置信息缺失或被拦截：
- 检查文件是否已保存（未保存的临时文件可能无法精确定位）
- 确认没有启用
editor.gotoLocation.multipleDefinitions相关覆盖配置，导致跳转逻辑被改写 - 某些插件（如
Auto Rename Tag或旧版Path Intellisense）会劫持光标行为，可尝试禁用后验证 - 终端或调试控制台正在聚焦时，Outline 跳转会静默失败——先点回编辑器再试
最易被忽略的一点：Outline 不是“静态目录”，它每秒都在监听文档变更并重新请求符号。一旦语言服务器响应超时（比如项目过大、硬盘卡顿、插件内存泄漏），Outline 就会退化为只读列表甚至清空。所以看到大纲异常，第一反应不该是重装插件，而是看左下角语言状态栏和开发者工具里的实时日志。
