大纲视图不自动高亮当前符号需检查三件事：文件必须已保存、语言模式必须正确、大纲视图需处于聚焦状态；ctrl+shift+o 默认触发符号搜索而非打开大纲面板；符号筛选效果取决于语言服务器支持的symbolkind；双击无响应时应确认节点可折叠性及macos下cmd+click替代操作。
大纲视图不自动高亮当前符号？检查这三件事
大纲视图默认会高亮编辑器中光标所在位置对应的符号，但常因配置或状态问题失效。这不是 bug，而是依赖明确条件才能触发同步。
-
文件必须已保存：部分语言服务器（如 TypeScript）仅对磁盘上存在的文件解析符号，未保存的变更不会更新大纲节点状态 -
语言模式必须正确：右下角状态栏显示的语言标识需匹配实际语法（例如.js文件不能是Plain Text，应为JavaScript） -
大纲视图需处于聚焦状态：如果刚从终端或搜索框切回来，大纲可能未激活同步逻辑；点击一下视图空白处或按Ctrl+Shift+P输入Outline: Focus on Outline View强制重置
Ctrl+Shift+O 为什么有时打开的是符号搜索，而不是大纲面板？
这是 VSCode 的快捷键复用机制导致的——Ctrl+Shift+O（macOS 是 Cmd+Shift+O）默认绑定的是 Go to Symbol in File 命令，不是大纲视图开关。很多人误以为它是“打开大纲”的快捷键，其实它调起的是一个临时下拉菜单。
- 真正打开大纲侧边栏的快捷方式是：
Ctrl+Shift+P→ 输入View: Toggle Outline，或直接点击侧边栏底部的大纲图标 - 若想用快捷键直接聚焦大纲面板（不打开/关闭，只把焦点切过去），运行命令
Outline: Focus on Outline View - 两者行为差异明显：符号搜索是瞬时弹出、输入即跳转的轻量操作；大纲视图是常驻面板，支持折叠、筛选、拖动排序等持续交互
符号类型筛选失效？重点看语言扩展支持粒度
右键大纲视图 → “配置大纲视图”里勾选的 Function、Class 等选项，并非所有语言都全量支持。是否显示某类符号，取决于对应语言服务器返回的符号种类（SymbolKind）。
- TypeScript/Python（Pylance）：完整支持
Function、Method、Class、Interface、Enum等，筛选效果稳定 - JavaScript（无 TS 配置）：可能只上报
Function和Variable，Class或Method不会出现，即使勾选也无效 - 自定义语言（如 .toml、.yaml）：多数不提供符号信息，大纲始终为空，此时筛选设置无意义
验证方法：打开命令面板，运行 Developer: Toggle Developer Tools，在 Console 中输入 vscode.workspace.getConfiguration('outline').get('show')，看返回值是否被语言扩展覆盖。
大纲里双击没反应？别急着重装插件
双击大纲条目本应展开/折叠其子结构（比如类里的方法列表），但 macOS 上常因系统级快捷键冲突或焦点丢失而静默失败。
- 先确认鼠标悬停时是否有手型光标：没有说明该节点不可折叠（例如顶层
const变量、独立函数通常无子节点） - macOS 用户注意：
Cmd+Click才是展开/折叠全部子节点的快捷键，双击行为在部分语言扩展中未启用或被禁用 - 更可靠的替代操作：聚焦大纲后，用方向键选中节点，再按
→展开 /←折叠；或右键节点选择“展开全部”
真正容易被忽略的是：大纲的折叠状态不跨会话持久化，每次重启 VSCode 或切换文件后都要重新展开，这点和代码块折叠不同——它只作用于当前视图实例，而非源码本身。
