ctrl+shift+o只显示当前文件符号，因其调用document symbol provider，仅对当前活动文档实时解析，不跨文件索引；而ctrl+p+@和ctrl+t调用workspace symbol provider，依赖语言服务器全量索引整个工作区。
Ctrl+Shift+O 为什么只显示当前文件的符号？
因为 Ctrl+Shift+O 调用的是 Document Symbol Provider，它只对当前已打开且已解析的文档生效，不跨文件索引。VSCode 不会主动扫描整个工作区来填充这个视图——它依赖语言服务器在编辑器焦点切换时，为当前活动文档实时提供 DocumentSymbol 列表。
常见误判场景：
- 打开一个
.js文件但没配jsconfig.json，TypeScript 语言服务降级，Ctrl+Shift+O只能提取顶层变量，漏掉函数内部声明 - 文件后缀是
.ts但内容实际是 JSON，状态栏显示 “JSON”，此时语言服务器不提供符号，大纲为空 - 使用
require('./foo')动态导入的模块，其导出符号不会出现在当前文件大纲中——大纲不解析运行时依赖
Ctrl+P+@ 和 Ctrl+T 的符号来源有何不同？
Ctrl+P+@ 触发的是 Workspace Symbol Provider，它基于语言服务器已完成的全量索引（如 TypeScript 的 program structure 或 rust-analyzer 的 crate graph），搜索范围是整个工作区中已被语言服务器纳入分析的文件。
Ctrl+T 是更底层的 workspace symbol 搜索入口，行为类似，但部分扩展（如 ESLint、Go）会禁用或弱化它，转而推荐 @ 前缀方式——因为 @ 显式表明意图是“找符号”，可绕过文件名匹配逻辑，避免和 Ctrl+P 默认的 fuzzy file search 冲突。
关键区别：
-
Ctrl+P+@fetchData：优先匹配函数/方法名，再按作用域排序（如先显示api/fetch.ts中的fetchData，再显示utils/request.ts中同名函数） -
Ctrl+T fetchData：可能混入文件名含fetchData的配置文件，结果不可控 - 若索引未完成（右下角状态栏显示 “Indexing…”），
@搜索会返回空，而Ctrl+Shift+O仍可用——后者不依赖后台索引
Outline 面板里点击跳转失败，问题通常不在快捷键
点击 Outline 中某项无反应，90% 情况下不是 UI 层面 bug，而是语言服务器返回的 range 或 selectionRange 不合法：比如位置超出文档长度、行号为 0、或字符偏移为负数。这类错误不会弹窗提示，只会静默失效。
验证方式：
- 按
Ctrl+Shift+P输入Developer: Toggle Developer Tools，切到 Console 标签，复现点击动作，看是否有Invalid range类报错 - 用
Ctrl+Click在源码中手动跳转同一符号：如果也失败，说明语言服务器根本没提供有效定义位置 - 检查该符号是否位于条件编译块内（如
#if DEBUG或/* istanbul ignore next */），某些语言服务器会跳过被标记为“不可达”的节点
Vue/TSX 文件的大纲结构为何总不完整？
Vue 单文件组件和 React JSX/TSX 文件的符号提取高度依赖扩展实现细节，不是 VSCode 内置能力。Volar（Vue）和 TypeScript 的 jsx 支持默认只提取 script 部分的符号，template 和 jsx 中的组件声明、hook 调用、甚至 const Comp = () => {} 这类函数表达式，常被忽略。
实操要点：
- Volar 必须启用
volar.takeOverMode，否则 Vue 文件被当作纯 HTML 处理，大纲只剩 template 标签 - React 项目需确保
"javascript.preferences.jsxAttributeCompletionStyle": "auto"和"typescript.preferences.jsxAttributeCompletionStyle": "auto"开启，否则 hooks 不被识别为可导出符号 - TSX 中使用
export default function Foo()能进大纲，但const Foo = () => {}+export default Foo可能丢失——取决于 TypeScript 语言服务是否将变量声明提升为“可导航符号”
真正影响导航效率的，从来不是快捷键记多少，而是你能否一眼判断出：此刻语言服务器到底在“看”什么、又“决定不看”什么。
