vscode大纲视图仅显示当前文件顶层符号，依赖语言服务器（lsp）提供documentsymbol信息；若无对应扩展、后缀不匹配、文件过大或语法错误，outline将为空。
VSCode 的大纲视图（Outline）不是靠“打开”就能直接看到完整结构的——它依赖语言服务器（LSP）提供符号信息，且默认只显示当前文件的顶层符号。项目级结构（比如跨文件跳转、模块依赖树）它不负责。
为什么 Outline 里什么都没显示？
最常见原因是当前文件没被对应语言服务器识别或解析失败：
-
outline靠textDocument/documentSymbolLSP 请求驱动，如果没装对应插件（如Python扩展、ESLint+TypeScript支持），就返回空 - 文件后缀名不匹配（比如写 TypeScript 却保存为
.js），或没配置"files.associations" - 文件过大（>1MB）、含语法错误、或语言服务器卡死时，
documentSymbol可能超时返回空数组 - 某些语言（如纯 HTML 或 JSON）默认不提供函数/类级符号，Outline 只显示
document根节点
怎么让 Outline 显示函数和类？
确保语言服务正常工作后，检查是否启用了符号折叠与层级过滤：
- 右键 Outline 面板 → 勾选
Filter: Show All Symbols（否则可能隐藏变量、常量等） - 在设置中搜索
outline.showInOutlineView，确认值为true - TypeScript/JavaScript 用户：确保
jsconfig.json或tsconfig.json存在且未禁用"include" - Python 用户：确认已安装
Pylance，且"python.languageServer"不是"Jedi"（旧版 Jedi 对 documentSymbol 支持弱）
{
"compilerOptions": {
"allowJs": true,
"checkJs": false
},
"include": ["src/**/*"]
}
Outline 能不能看整个项目的结构？
不能。Outline 是单文件视图，它不聚合多文件符号。想实现项目级导航，得换工具：
- 用
Ctrl+P（Windows/Linux）或Cmd+P（macOS）输入@查当前文件符号；输入#搜索项目内所有符号（需支持 LSP 的扩展，如 Pylance、TypeScript 自带） - 安装
Project Manager或File Utils扩展管理多根工作区 - 大型项目建议配合
Search: Find in Files（Ctrl+Shift+F）或使用Tree View中的Reveal in Explorer定位定义位置
Outline 点击跳转失效怎么办？
跳转失败通常不是 Outline 本身问题，而是符号定位链断裂：
- 检查
Go to Definition（F12）是否正常——如果也不行，说明语言服务器没正确解析引用路径 - TS/JS 项目：确认
tsconfig.json中"baseUrl"和"paths"配置被 Pylance/TypeScript 正确读取 - Python 项目：若用虚拟环境，确保 VSCode 已选中该解释器（状态栏右下角 Python 版本号要对）
- 重启语言服务器：命令面板（
Ctrl+Shift+P）运行Developer: Restart Language Server
Outline 的价值不在“全貌”，而在快速筛选当前文件的关键结构。真正容易被忽略的是：它不缓存、不索引、不跨文件——每次点击都实时请求符号，所以响应慢 ≠ 插件卡，很可能是 LSP 正在解析类型定义或等待第三方库加载。
