cmd+shift+o调出的是内联符号浮层而非侧边栏outline视图；真正呼出并驻留outline需用outline: toggle outline view命令，其依赖语言服务器提供documentsymbol数据，且键盘操作须先聚焦面板。
Cmd+Shift+O 是最直接的呼出方式，但要注意它打开的是内联符号列表而非侧边栏 Outline 视图
很多人误以为 Cmd+Shift+O（macOS）或 Ctrl+Shift+O（Windows/Linux）会唤出侧边栏的 Outline 面板，其实它调用的是「转到符号」（Go to Symbol）功能——一个临时浮层，只显示当前文件符号名称，不支持折叠、筛选、右键操作，也不保留状态。
真正要“一键呼出大纲视图”并长期驻留侧边栏，必须区分两个命令：
-
Outline: Toggle Outline View：切换 Outline 面板在侧边栏的显隐（推荐绑定快捷键） -
Outline: Focus on Outline View：焦点跳转到已存在的 Outline 面板（适合键盘流用户）
如果你按了 Cmd+Shift+O 却没看到结构树，不是功能失效，而是你压根没启用 Outline 面板——它和那个浮层是两套逻辑。
Outline 面板不显示？先检查语言服务器是否就绪，而不是翻设置
Outline 视图依赖语言服务器（LSP）提供 DocumentSymbol 数据。如果面板空白或只显示“Loading…”，大概率不是 VSCode 问题，而是语言扩展没跑起来。
- 打开一个
.py文件，确认已安装 Microsoft Python 扩展，并且右下角状态栏显示 “Pylance” 或 “Python Language Server” 正在活动 - 打开一个
.ts文件，检查是否启用了 TypeScript 插件；若用 Volar 处理 Vue，需确保其 DocumentSymbol 支持已开启（部分旧版本默认关闭） - 运行
Developer: Toggle Developer Tools，在 Console 中搜索Failed to resolve document symbols，有则说明 LSP 返回空或报错
语法错误本身通常不影响大纲生成，但若整个文件被语言服务器判定为“非有效模块”（比如顶层 await、非法 export 顺序），符号提取可能被跳过。
折叠/展开操作必须先聚焦 Outline 面板，方向键才生效
Outline 面板的键盘控制是“焦点敏感”的：只有当面板本身获得焦点（不是编辑器，也不是资源管理器），→ 和 ← 才能展开/折叠节点。
- 用
Cmd+Shift+P运行Outline: Focus on Outline View是最稳的聚焦方式 - 鼠标点击 Outline 面板任意位置也能聚焦，但容易误点进编辑器导致失焦
-
Cmd+Click（macOS）或Ctrl+Click（Windows/Linux）在节点上可展开/折叠全部子级，比逐层按方向键快得多
注意：折叠状态不会跨会话保存。关掉再重开文件，所有节点默认展开——这不是 bug，是设计如此。如需持久化，得靠扩展如 Expand Region 类工具，原生不支持。
大型文件中 Outline 响应慢？别硬等，试试过滤 + 排序组合技
当文件超过 2000 行，Outline 面板加载延迟明显，尤其含大量嵌套函数或装饰器时。此时盲目等待不如主动干预：
- 在 Outline 顶部过滤框输入
class或def（Python）、function（JS）、public（Java），直接筛出目标类型 - 右键 Outline 空白处，选择 “Sort By: Kind”，把类、接口、方法分组排列，比默认按位置排序更易定位逻辑块
- 禁用不必要的符号类型：在设置里搜
outline.showVariables，设为false可显著减少节点数量（变量名往往占 60%+）
真正难处理的不是“看不到大纲”，而是大纲里混着太多干扰项——比如自动生成的 __init__、TypeScript 的类型别名、Vue 模板里的内联表达式。删减显示粒度，比优化性能更立竿见影。
