VSCode的Outline和符号跳转依赖语言扩展提供的语义信息，未安装对应扩展或文件未被正确识别会导致面板为空、跳转失效；需检查扩展、语言模式、服务器日志及语法正确性。
vscode 的代码大纲（outline）和符号跳转（go to symbol）本身不依赖插件，但实际可用性高度取决于当前文件的语言支持程度——没装对的语法扩展，outline 面板就是空的，ctrl+shift+o（windows/linux）或 cmd+shift+o（macos）也搜不到任何函数或类。
为什么 Outline 面板里什么都没有？
根本原因不是 VSCode 有问题，而是它没拿到有效的语言语义信息。VSCode 自身不解析 Python/TypeScript/Go 等语言的 AST，全靠对应语言扩展提供的 DocumentSymbolProvider 接口。
- 确保已安装官方推荐扩展：比如
Python（Microsoft）、ESLint+TypeScript（内置但需项目有tsconfig.json）、Go（Go Team） - 检查状态栏右下角语言模式是否正确：点击它可手动切换，比如从
Plain Text改为TypeScript - 某些文件（如无后缀的配置文件、.env）即使装了扩展也不会被识别——它们不在该扩展的
languageIds声明范围内
Ctrl+Shift+O 跳转不了函数？试试这些条件
Ctrl+Shift+O 默认列出当前文件的符号；加一次 Ctrl（即 Ctrl+Ctrl+Shift+O）才搜索工作区全部符号。但能否跳转还受以下限制：
- 符号必须被语言服务器成功索引：保存文件触发重新解析，未保存的修改可能不生效
- 部分语言不支持嵌套符号：比如 Rust 的 impl 块内方法，在旧版
rust-analyzer中可能不出现在大纲中 - 正则过滤支持通配符：输入
use*可匹配useState、useEffect；输入:hook（冒号前缀）在 TypeScript 中会只显示 React Hook 类型符号
Outline 面板折叠/排序不按预期？
Outline 默认按源码顺序展示，不自动按字母或作用域分组。它的行为由扩展控制，但你可以干预显示效果：
- 点击面板右上角
⋯→ 勾选Sort by Kind可把类、函数、变量分开排列 - 取消勾选
Hide Outline When Empty，避免切换文件时 Outline 面板突然消失 - 某些扩展（如
Vue Language Features）支持自定义大纲层级，需在settings.json中配置"vue.outline.showProperties": true
符号跳转失效却没报错？先看 Output 面板
语言服务器出问题时往往静默失败。打开 View → Output，在下拉菜单中选择对应语言（如 TypeScript Server 或 Python），观察是否有如下线索：
-
Failed to resolve workspace symbols：通常是node_modules过大导致超时，可设"typescript.preferences.includePackageJsonAutoImports": "auto" -
Cannot read property 'map' of undefined：常见于 ESLint 扩展与 Prettier 冲突，禁用其中一个再试 - 空日志 + Outline 为空：大概率是语言服务器根本没启动，检查扩展是否被禁用，或运行命令
Developer: Toggle Developer Tools看 Console 有无ERR报错
真正卡住的点往往不是快捷键记不住，而是语言服务器没跑起来、文件没被正确识别、或者符号本身因语法错误（比如少了个 }）而无法被解析——这些不会弹红框，只会让 Outline 和跳转功能「安静地失效」。
