code outline 目录树不显示函数或类，根本原因是 vscode 未启用对应语言的符号解析服务；需确认安装并启用 typescript/javascript 官方扩展、检查语言模式、重启编辑器，并查看开发者工具报错。
为什么 Code Outline 插件生成的目录树不显示函数或类？
常见现象是安装后大纲面板为空，或只显示部分符号（比如只有 # 标题），但 TypeScript/JavaScript 文件里的 function、class、const 等完全不出现。根本原因不是插件没装好，而是 VSCode 没启用对应语言的符号解析服务。
实操建议：
- 确认已安装对应语言的官方扩展：如
ESLint、TypeScript Language Features（内置，但需确保未被禁用），Python 项目必须装Pylance或Python扩展 - 打开命令面板（
Ctrl+Shift+P），执行Developer: Toggle Developer Tools，切换到 Console 标签页，查看是否有类似"Failed to resolve document symbols"的报错 - 检查当前文件是否被识别为正确语言模式：右下角状态栏应显示
TypeScript或JavaScript，而不是Plain Text；若不对，点击该区域手动选择 - 重启 VSCode —— 符号提供器（Symbol Provider）通常在首次加载语言扩展时注册，热重载不一定生效
如何让 Code Outline 只显示函数和类，隐藏变量和导入？
默认行为会把所有符号（包括 import、const、let）都列出来，干扰导航。这不是 bug，而是插件默认开启全量符号展示。
实操建议：
- 打开设置（
Ctrl+,），搜索code outline filter，找到Code Outline: Filter Symbols配置项 - 填入 JSON 数组，例如：
["function", "class", "method", "interface"]—— 注意字段名必须小写且与 LSP 规范一致 - 不推荐用正则过滤名称（如排除
import），因为符号类型（type）比名称更稳定；LSP 返回的 symbol.kind 字段才是真实分类依据 - 若想临时关闭某类符号，可在大纲面板右上角点击齿轮图标 → 取消勾选对应类型（该操作仅当前会话有效）
Markdown 文件里用 Code Outline 能看到标题结构吗？
不能。Code Outline 依赖 Language Server 提供的 DocumentSymbol 数据，而 VSCode 内置的 Markdown 语言服务器不实现该能力 —— 它只提供预览、链接跳转等基础功能，不暴露符号树。
实操建议：
- Markdown 目录请改用专用插件，如
Markdown All in One（快捷键Ctrl+Shift+P→Create Table of Contents） - 如果硬要用 Code Outline，可尝试安装第三方 Markdown LSP 扩展（如
marksman），但兼容性差、维护不稳定，不建议生产环境使用 - 注意区分：VSCode 左侧资源管理器里的「大纲」视图（Outline）对 Markdown 是支持标题层级的，但那是编辑器原生功能，和 Code Outline 插件无关
多根工作区下 Code Outline 总卡在第一个文件夹的符号？
现象是打开含多个文件夹的 workspace，大纲只显示第一个文件夹里当前打开文件的结构，切换到其他文件夹的文件时，树不更新或仍显示旧内容。
实操建议：
- 检查 workspace 设置中是否启用了
"code-outline.useWorkspaceSymbols": true（默认 false）；设为true后插件会尝试聚合所有文件夹的符号 - 但实际效果取决于各语言服务器是否支持跨文件夹索引 —— TypeScript/JavaScript 通常支持，Python（Pylance）需开启
python.defaultInterpreterPath并确保各子文件夹有独立pyproject.toml或venv - 更可靠的做法是：关闭多根 workspace，单独打开每个子项目文件夹；Code Outline 对单根项目响应最稳定
- 若必须用多根，可配合
settings.json在每个文件夹下单独配置"code-outline.enabledLanguages"，避免某语言扩展在非目标文件夹里抢注符号提供器
