outline视图不显示符号主因是语言服务器未就绪，需检查扩展安装、语言模式、配置文件及语法合法性；符号显示由lsp按ast解析决定，受语言特性与扩展配置制约，修改后需重新打开文件生效。
Outline 视图不显示函数或类？检查语言服务器是否就绪
VSCode 的 Outline 视图（左下角图标或 Ctrl+Shift+O）依赖当前文件的语言服务器（LSP）提供符号信息。如果打开一个 .py 文件却只看到“No symbols found”，大概率是 Python 扩展没激活，或没成功启动 Pylance/Python LSP。
实操建议：
- 确认已安装对应语言扩展（如
Python、ESLint、Rust Analyzer），且未被禁用 - 查看状态栏右下角语言模式是否正确（如显示
Python而非Plain Text） - 按
Ctrl+Shift+P输入Developer: Toggle Developer Tools，在 Console 里搜Failed to start language server或类似报错 - 对 JavaScript/TypeScript，确保有
jsconfig.json或tsconfig.json，否则 LSP 可能只解析单文件，无法识别跨模块导出
Outline 显示的符号层级混乱？看语言特性和代码结构
Outline 不是简单按缩进排序，而是解析 AST 后提取声明式符号（function、class、const、export 等）。不同语言行为差异明显：
- TypeScript 中
interface和type默认不显示，需开启"typescript.preferences.includePackageJsonAutoImports": "auto"并重启服务 - Python 中只有顶层
def和class入列，嵌套函数（def inner():）不会出现在 Outline - JavaScript 模块中，
const foo = () => {}这类函数表达式默认不作为符号列出，改用function foo() {}或启用javascript.suggest.autoImports - CSS 文件里，
.class-name选择器不会出现，但@keyframes和@media块会作为符号展示
点击 Outline 条目跳转失效？注意作用域和语法合法性
Outline 条目点击后跳转失败，常见原因不是视图问题，而是源码本身存在解析障碍：
- 当前行上方有语法错误（如 JS 中漏了
}、Python 中缩进混用 Tab/Space），LSP 会中断符号收集，后续符号可能丢失或定位偏移 - 符号名含非法字符（如
my-function在 JS 中是合法标识符但不会被识别为函数名；Python 中def my_func():可见，def my-func():直接报错） - 使用了动态构造（
Object.defineProperty、eval、__getattr__），LSP 无法静态推断，自然不会入列 - Vue 单文件组件中，
<script setup></script>里的const fn = defineExpose(...)不会进入 Outline，因为defineExpose是运行时 API
想自定义 Outline 显示内容？靠语言配置而非通用设置
VSCode 没有全局开关控制“哪些符号显示”，所有过滤逻辑由语言扩展实现。你无法通过 settings.json 强制让 Python 显示私有方法（_helper()），但可以调整部分行为：
- Python 扩展中启用
"python.analysis.autoSearchPaths": true，有助于跨文件符号识别 - TypeScript 中设置
"typescript.preferences.includeCompletionsForImportStatements": true，能让 import 行出现在 Outline（仅限 TS v4.9+） - 所有语言都支持
outline.showClasses、outline.showFunctions等布尔配置项，但实际生效取决于扩展是否实现——比如 Rust Analyzer 就不响应这些开关 - 真正可控的是排序：默认按位置，可右键 Outline 标题栏 → “Sort by Name” 切换顺序
最常被忽略的一点：Outline 是实时解析的，但不会自动重载。改完配置或装完扩展后，必须重新打开文件（或关闭再打开标签页），而不是仅刷新窗口。
