VSCode大纲视图依赖语言服务器提供的语义符号数据，Ctrl+Shift+O仅查当前文件且无需索引，而Ctrl+P+@支持跨文件搜索但需全量索引完成；列表为空或跳转失败多因LSP未就绪、语法错误、配置不当或返回非法位置。
VSCode 的大纲（Outline）视图不是装饰品，它直接决定你查函数、跳定义、理结构的快慢。对 C、Python、TypeScript 等语言，只要语言服务器正常工作，Ctrl+Shift+O 一按就能看到当前文件所有函数、结构体、宏、变量——不靠滚动、不靠 Ctrl+F 猜拼写。
为什么按 Ctrl+Shift+O 没反应或列表为空？
这不是快捷键失效，而是语言服务器没提供符号数据。常见原因包括：
- C 项目没装
C/C++扩展，或已安装但状态栏右下角显示 “C” 后跟着 “Loading…” 长时间不消失 - Python 文件没启用
Pylance（检查状态栏语言模式是否为 “Python”，而非 “Plain Text”） - 文件未保存：部分语言服务器（如早期版本的 clangd）默认只解析已保存文件
- 语法错误卡住解析：比如少了个
}或;，LSP 会停在错误行，后续符号不进大纲 - 函数写在预处理器条件块里，如
#ifdef DEBUG内部，且当前配置未启用该宏
Ctrl+Shift+O 和 Ctrl+P+@ 到底用哪个？
二者调用不同底层接口，适用场景完全不同：
-
Ctrl+Shift+O调用Document Symbol Provider，只查当前打开文件，响应快、无需索引，适合单文件内快速定位 -
Ctrl+P+@调用Workspace Symbol Provider，依赖语言服务器已完成的全量索引，能跨文件搜函数名，但首次使用前需等右下角 “Indexing…” 消失 - 搜
init_uart时，如果它在hal.c里但你正在编辑main.c，Ctrl+Shift+O不会出现；必须用Ctrl+P+@init_uart - 若索引卡住，
Ctrl+P+@返回空，而Ctrl+Shift+O仍可用——这是你排查问题的第一个线索
点击大纲条目却跳不到位置？别急着重装插件
90% 的“点击无反应”不是 UI 故障，是语言服务器返回了非法位置信息。验证方法很直接：
- 按
Ctrl+Shift+P输入Developer: Toggle Developer Tools，切到 Console 标签 - 再点一次大纲里的函数名，看控制台是否输出类似
Invalid range: {start: {line: -1, character: 0}, ...}的报错 - 同时用
Ctrl+Click在源码中点击同一函数名：如果也跳不动，说明是 LSP 解析异常；如果能跳，说明大纲面板自身 range 字段构造出错 - 临时解决：保存文件 → 重启 VSCode → 确保
c_cpp_properties.json中includePath正确（C 项目尤其关键）
真正容易被忽略的是：大纲依赖的是语义解析（AST），不是文本匹配。哪怕你在注释里写了 // func_handle_irq，它也不会出现在大纲里；但只要有一个合法的 void handle_irq(void) 声明，哪怕夹在二十层嵌套宏里，只要 clangd 能展开，它就大概率会出现在列表中。
