vscode outline 显示空白或仅类名，主因是语言服务器未上报函数符号；需检查lsp状态、配置项outline.symbols是否启用、标识符是否符合语法规范。

Outline 显示空白或只显示类名，不列函数？先查语言服务器状态

VSCode 的 Outline 视图根本不会“自己猜”函数在哪——它完全依赖当前语言服务器（LSP）返回的 DocumentSymbol 数据。如果函数没出现，大概率不是过滤问题，而是语言服务器压根没把它们上报。

常见表现：No symbols found in document、大纲里只有顶层 class 名、def 或 function 关键字全无踪影。

• 打开命令面板（Ctrl+Shift+P），运行 Developer: Toggle Developer Tools，切到 Console 标签页，看是否有 Failed to resolve symbol provider 类报错
• 再打开 Output 面板（Ctrl+Shift+U），在右上角下拉菜单中选对应语言（如 Python、Rust Analyzer、C/C++），观察启动日志是否卡在 “initializing…” 或报路径/配置错误
• 对 Python：确认右下角显示的是 Python 而非 Plain Text，且 Pylance 已启用（禁用 MS Python 扩展后 Pylance 会自动接管）
• 对 C/C++：确保已安装官方 C/C++ 扩展，并在项目根目录 .vscode/settings.json 中配置了 "C_Cpp.intelliSenseEngine": "default"

符号被过滤掉？检查 settings.json 里的 outline 相关开关

VSCode 确实有隐藏符号的机制，但不是靠“过滤器界面”，而是靠几个底层配置项。它们默认开启，一旦被手动关掉，函数就直接消失。

打开 settings.json（文件 → 首选项 → 设置 → 右上角 {} 图标），重点核对以下几项：

• "outline.showHidden": true —— 控制是否显示带 _ 前缀的私有成员（Python 中 _func()、TS 中 private method()）
• "outline.symbols": true —— 必须为 true，否则整个大纲符号层被禁用（有些插件重置设置时会误关）
• "typescript.preferences.includeInferredTypes": false —— 若设为 true，TS 可能因类型推导失败而跳过部分函数符号（尤其未显式标注返回类型的箭头函数）
• "editor.symbolSearch.mode": "all" —— 影响 Ctrl+Shift+O 面板行为，但不影响左侧 Outline 固定视图；不过若这里设成 "workspace" 且当前文件不在打开的文件夹中，也可能间接导致符号缺失

搜索框里输名字没反应？注意 @ 前缀和大小写敏感性

Outline 顶部的搜索框不是简单字符串匹配，它支持类型限定语法，而且默认区分大小写（取决于语言服务器实现）。

例如你在写 React 函数组件，搜 useEffect 没结果，试试：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• @function useEffect —— 强制只匹配函数类型（部分语言服务器如 rust-analyzer 支持，TS/Python 也基本支持）
• @class MyComponent —— 排除函数干扰，直奔类定义
• handle（不加 @）→ 可能匹配到 handleClick、handleRequest、甚至注释里的 // handle error（取决于语言服务器是否索引注释）
• 若搜小写 render 没结果，但代码里是 Render 开头，说明该语言服务器开启大小写敏感匹配（如某些旧版 Python 扩展），此时必须严格按源码大小写输入

连续按两次 Ctrl+Shift+O 会唤出独立符号面板，它比左侧 Outline 搜索更宽松、支持模糊补全，适合快速定位。

函数名含短横线、点号或 Unicode？那不是大纲的问题，是语法本身不合法

大纲不显示，有时真不是 VSCode 的锅。比如你写了 const my-component = () => {}（JS）或 def my-func():（Python），这些根本不是合法标识符，语言服务器解析阶段就会跳过或报错，自然不会生成符号。

这类写法在 JS 中虽可作为对象属性存在，但无法被识别为函数声明；Python 则直接语法错误，连文件都打不开。

真正能进 Outline 的名字，必须满足当前语言的 IdentifierName 规则：

• JS/TS：只能是字母、$、_ 开头，后续可接数字（如 initData、$ref、_internal）
• Python：同上，且不能是关键字（def class(): 不会出现在大纲里）
• Rust：允许 Unicode 字母，但禁止 - 和 .（fn do_something() ✅，fn do-something() ❌）

别在名字里玩花样，大纲才不会跟你兜圈子。名字合规，符号才可能被看见；名字违规，连语言服务器都懒得理你。