Outline面板空白因缺少语言服务器支持，需确认文件类型、安装对应扩展、保存文件并设置正确语言模式；大纲默认不显示参数类型，悬停可查看提示。
为什么 Outline 面板没显示任何内容
VS Code 的代码大纲（Outline）依赖语言服务器（LSP）提供符号信息，不是所有文件类型默认支持。比如打开一个纯 .txt 文件或未启用对应扩展的 .js 文件，Outline 面板会空白——这不是 bug，是缺少语义解析能力。
确认是否生效：打开一个已安装对应语言支持的文件（如 index.ts），按 Ctrl+Shift+O（Windows/Linux）或 Cmd+Shift+O（macOS），看是否弹出跳转列表；再检查左侧边栏 Outline 视图是否同步更新。
- 确保已安装对应语言扩展（如
ESLint不提供大纲，但TypeScript and JavaScript Language Features原生支持） - 文件必须保存（未保存的临时文件可能不触发 LSP 解析）
- 检查状态栏右下角语言模式是否正确（点击可切换，例如从
Plain Text改为TypeScript）
Outline 里为什么看不到函数参数或类型信息
大纲默认只显示符号名称和层级结构，不展开签名细节。这是性能权衡：实时渲染完整类型声明会拖慢大型文件响应速度。
想快速查看定义签名？把鼠标悬停在 Outline 中的条目上，会浮现出简略类型提示；或者直接在编辑器中按住 Ctrl（Windows/Linux）或 Cmd（macOS）并点击符号名，跳转到定义处。
- 部分扩展（如
Python扩展）支持配置"python.analysis.extraPaths"来增强符号识别范围 - TypeScript 用户可检查
tsconfig.json是否启用了"include"，避免因路径排除导致符号丢失 - 如果用的是
JavaScript而非TypeScript，建议添加 JSDoc 注释，能显著提升大纲中函数参数的可见性
如何让自定义文件类型也支持 Outline
VS Code 不会自动为未知后缀文件启用大纲，但可通过关联语言模式 + 启用对应语言服务实现。例如你写的是配置驱动的 DSL 文件 .workflow，想让它像 JSON 一样显示大纲，需两步：
- 在设置中搜索
files.associations，添加"*.workflow": "json"（前提是该格式语法兼容 JSON） - 更稳妥的方式是使用
Language Support for YAML等扩展，并在其配置中加入自定义 schema（通过yaml.schemas关联） - 若需完全自定义大纲结构（比如解析特定注释标记），得开发简单语言扩展，实现
DocumentSymbolProvider接口——普通用户不建议走这条路
大纲折叠/排序异常或响应迟缓怎么办
大型文件（尤其含数百个导出项的模块）可能导致 Outline 渲染卡顿或折叠状态错乱。这不是界面问题，而是 LSP 在后台持续同步符号树时的资源竞争表现。
- 关闭不必要的扩展（特别是多个 LSP 客户端同时激活同一文件类型时）
- 在设置中调整
"typescript.preferences.includePackageJsonAutoImports": "auto"可减少 Node 模块符号爆炸式增长 - 禁用「自动展开」行为：修改设置
"outline.showAllSymbols": false，只显示当前滚动视口附近的符号，大幅提升响应速度
真正难处理的是跨文件符号引用缺失——比如一个 export const foo = ... 在另一个文件里被解构导入，但大纲不显示该导入点。这属于语言服务器设计限制，目前没有通用开关能强制索引所有引用位置。
