vscode默认支持typescript、javascript、python、go、rust、c#等主流语言的大纲导航，只要语法规范（如def/class/function/class声明）即可自动提取符号；不支持的语言或语法错误会导致“no symbols found”。
VSCode 默认支持代码折叠和大纲导航，但需要满足语言语法特征或安装对应扩展，否则部分结构（如自定义函数块、注释区）无法折叠，大纲里也看不到函数/类列表。
哪些语言默认支持大纲（Outline）？
TypeScript、JavaScript、Python、Go、Rust、C# 等主流语言开箱即用，只要文件有标准的函数/类声明语法，Outline 视图就能自动提取。比如 Python 中 def foo(): 和 class Bar: 会被识别；JS/TS 中 function foo()、const bar = () => {}、class Baz 同样生效。
不支持的语言（如纯文本、Shell 脚本、JSON）或语法不规范的代码（如 JS 里漏写 function 关键字、用对象字面量模拟模块但无命名导出），Outline 面板会显示 “No symbols found in document”。
- 检查是否启用：打开侧边栏
Outline（快捷键Ctrl+Shift+O/Cmd+Shift+O） - 确认当前文件关联了正确语言模式（右下角看语言标识，点击可切换）
- 某些语言需安装官方扩展（如 Python 需
ms-python.python，否则大纲仅显示基础结构）
为什么我的代码块不能折叠（比如 if 块、注释段）？
VSCode 折叠依赖两种机制：语法感知折叠（semantic folding）和缩进折叠（indentation folding）。前者由语言服务器提供，后者是兜底方案，但默认关闭。
- 默认只对函数、类、条件块、循环等语法节点折叠（如
if、for、function） - 普通缩进块（如连续多行注释、配置对象）不会自动折叠，除非开启
"editor.foldingStrategy": "indent" - 注释折叠需语言支持：JS/TS 支持
/* #region *///* #endregion */；Python 支持#region/#endregion（需 Pylance 或 Python 扩展） - 自定义折叠标记必须成对出现，且在同一缩进层级，否则折叠无效
如何让 JSON/YAML/HTML 文件也能折叠？
这些格式本身无函数/类概念，大纲基本为空，但折叠仍可启用——靠的是语言内置的折叠规则或手动标记。
- JSON：VSCode 自带折叠支持，基于大括号/方括号层级，无需额外设置
- YAML：需安装
redhat.vscode-yaml扩展，才能按缩进或键名折叠（如折叠整个spec:块） - HTML：默认支持标签对折叠（
<div>...</div>），但自定义区域需用<!-- #region -->/<!-- #endregion --> - 所有文件都可通过
Ctrl+Shift+[/]手动折叠/展开当前缩进层级
折叠和大纲失效时最先该查什么？
不是重装插件，而是先确认三个硬性前提：
- 文件是否保存（未保存的临时文件可能不触发语言服务）
- 右下角语言模式是否正确（例如 .js 文件被误设为 Plain Text）
- 对应语言扩展是否已启用且无报错（在
Output面板切换到对应语言标签，看是否有初始化失败日志）
特别容易忽略的是：某些项目根目录下有 .vscode/settings.json，里面若写了 "editor.folding": false 或禁用了语言服务器，就会全局压制折叠功能。
