outline视图为空需先确认语言支持和文件类型：如未安装rust analyzer则.rs文件不显示，php需intelephense并配置路径；js/ts默认支持，python需pylance；报错“no symbol provider”即服务未就位。
Outline 视图为什么没内容？先确认语言支持和文件类型
大纲（Outline）视图显示为空，最常见的原因是当前文件没有被 VSCode 的语言服务识别为可解析结构的类型。比如打开一个 .rs 文件但没装 Rust Analyzer 插件，或打开 .php 文件却只装了基础 PHP 插件而没启用 LSP 支持，Outline 就会一直卡在 Loading… 或直接空白。
验证方式很简单：打开命令面板（Ctrl+Shift+P），输入 Developer: Toggle Developer Tools，切换到 Console 标签页，再点一下 Outline 面板——如果有报错如 "No symbol provider registered for 'php'"，就说明语言服务没就位。
- JavaScript/TypeScript：默认支持，无需额外插件
- Python：需安装
Pylance或Python官方扩展，并确保启用了python.languageServer - Rust：必须安装
Rust Analyzer，禁用旧版Rust扩展 - PHP：推荐
intelephense或PHP Intellisense，且要在设置中开启intelephense.environment.includePaths等路径配置
如何让 Outline 只显示函数和类，不显示变量？
默认情况下，Outline 会把变量、常量、导入语句等全列出来，尤其在大型文件里干扰严重。关闭变量显示是最直接的提效操作，但不能直接改 settings.json ——很多用户发现该文件是只读的，因为它是 VSCode 自动生成的缓存配置。
正确做法是通过图形界面修改：
- 按
Ctrl+,打开设置 - 在搜索框输入
outline.showVariables - 取消勾选该项（值变为
false） - 同理可关掉
outline.showConstants、outline.showImports等非导航主干项
这些开关对所有语言生效，但实际效果取决于语言服务器是否返回了对应符号类型。比如某些 PHP 插件不区分 const 和 define()，关掉 showConstants 也可能无效。
Code Outline 插件比内置 Outline 强在哪？什么时候该换？
VSCode 内置的 Outline 是轻量、稳定、无额外依赖；Code Outline 插件则提供更细粒度控制，适合对导航体验有明确诉求的场景。
它真正有用的功能集中在三处：
-
editor.codeOutline.showIcons：开关图标，能一眼区分function、class、interface类型 -
editor.codeOutline.showNumbers：显示行号，跳转前就能预判代码块长度 - 支持在树节点上右键 →
Copy Symbol Path，方便写文档或发给同事定位位置
注意：Code Outline 不替代语言服务，它只是“画图层”。如果内置 Outline 都没内容，装它也没用。另外它不支持 Markdown 标题大纲（那是 VSCode 原生功能），别指望用它整理 README。
快捷键和面板位置容易被忽略的细节
很多人习惯用鼠标点侧边栏图标唤出 Outline，但其实最稳的唤起方式是快捷键：Ctrl+Shift+O（Windows/Linux）或 Cmd+Shift+O（Mac）。这个快捷键始终聚焦到 Outline 视图，哪怕它当前被折叠或隐藏在其他面板后面。
另一个常被忽略的点是面板拖动逻辑：Outline 默认可能出现在底部面板区（尤其你装过 GitLens 或 Terminal 后），这时它会变成标签页形式，无法和资源管理器并排。解决方法是用鼠标左键按住 Outline 标题栏，拖到左侧活动栏区域（资源管理器下方），松手后它就会固定为侧边栏子面板，和文件树共存。
最后提醒一句：Outline 显示的是**当前激活编辑器**的内容，不是整个项目。切到另一个 tab，Outline 自动刷新——这点看似简单，但新手常在多文件间来回切时误以为“Outline 坏了”。
