VSCode原生Outline为空并非配置问题，而是语言服务器（LSP）未就绪；它依赖rust-analyzer、Pylance等插件提供符号数据，自身不解析代码。
VSCode 原生 Outline 视图为什么点开是空的
不是配置没开，而是语言服务器（LSP）没就绪。VSCode 的 Outline 面板本身不解析代码，它依赖后端插件（如 rust-analyzer、Pylance、TypeScript Server）提供符号数据。常见现象包括：
- 打开
.rs文件后 Outline 显示Loading...或空白 →rust-analyzer正在索引或崩溃 - 打开
.py文件无函数/类节点 →Pylance未启用，或 Python 解释器路径未正确配置 -
.ts文件有大纲但缺失接口或类型别名 → TypeScript 版本过低，或jsconfig.json/tsconfig.json未被识别
验证方式：按 Ctrl + Shift + P 输入 Developer: Toggle Developer Tools，切到 Console 标签页，查看是否有 Failed to resolve document symbols 类错误。
如何让 Outline 正常显示 Rust / Python / TypeScript 的符号
核心是确保对应语言插件已激活且能通信。不同语言处理逻辑一致，但关键动作略有差异：
- Rust：卸载并重装
rust-analyzer插件，或切换至Pre-Release版本；确认项目根目录含Cargo.toml；索引完成前左下角会显示Rust Analyzer is loading… - Python：检查右下角状态栏是否显示 Python 解释器路径；若为
None，点击后选择已安装环境；禁用其他 Python 插件（如 Jedi），只留Pylance - TypeScript：确保工作区存在
tsconfig.json；若用 JS 项目，需有jsconfig.json并启用"checkJs": true；避免在未打开文件夹的单文件模式下使用
所有语言都适用的兜底操作：Ctrl + Shift + P → 输入 Developer: Reload Window，强制重启语言服务上下文。
Code Outline 插件比原生 Outline 强在哪
原生 Outline 是 VSCode 内置功能，而 Code Outline 是第三方扩展，它不替代 LSP，而是增强呈现与交互能力。主要差异点：
- 独立视图区域：原生 Outline 挤在侧边栏底部，
Code Outline可固定在右侧独立面板，支持拖拽调整宽度 - 搜索过滤更灵敏：顶部带实时搜索框，输入
handle可同时匹配handleClick、handleRequest等，原生 Outline 仅支持模糊匹配且无高亮 - 图标+行号支持：通过设置
editor.codeOutline.showIcons和editor.codeOutline.showNumbers可开启符号类型标识和定义行号，便于快速识别作用域 - 跨文件符号聚合（部分版本）：在大型项目中可配置扫描多个文件，生成聚合大纲（需手动启用，非默认行为）
注意：Code Outline 仍依赖底层 LSP 提供符号，它只是“更好看的显示器”，不是“更强的解析器”。
Markdown 文件的大纲为何不显示标题层级
VSCode 对 Markdown 的大纲支持是独立机制，不走 LSP，但容易因配置开关关闭而失效。典型原因：
-
explorer.experimental.showOutline未启用 → 导致资源管理器里不显示大纲图标 -
markdown.preview.toc设为false→ 影响预览窗口内的 TOC，但不影响编辑器侧边 Outline - 文件未保存或未识别为
markdown语言模式 → 查看右下角状态栏，确保显示Markdown，不是Plain Text
快速验证：新建 test.md，输入 # Hello + ## World，保存后按 Ctrl + Shift + O，应立刻出现两层节点。若无反应，直接在设置中搜索 showOutline 并勾选即可。
真正卡住人的地方，往往不是“怎么打开 Outline”，而是“为什么它没数据”——背后永远是语言服务的状态、配置范围、文件上下文三者之一出了偏差。别急着换插件，先看左下角状态栏提示，再开开发者工具查报错，90% 的问题都在这两步里暴露出来。
