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，而是增强呈现与交互能力。主要差异点：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 独立视图区域：原生 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% 的问题都在这两步里暴露出来。