VSCode的代码折叠与大纲功能依赖语言扩展和服务器：JavaScript/TypeScript/HTML/CSS/JSON内置支持；Python需官方扩展+Pylance；Go/Rust等需语言服务器提供FoldingRange和DocumentSymbol；无服务器时仅缩进折叠；大纲为空常见于文件未保存、服务器未启动、语言模式错误或视图被过滤；自定义#region需对应语言配置启用。
VSCode 默认支持代码折叠和大纲视图，但具体效果取决于语言扩展、文件类型和设置是否启用——不是所有语言都默认开启完整折叠逻辑，也不是所有结构都能被识别为大纲节点。
哪些语言支持代码折叠与大纲？
折叠能力由语言扩展提供：内置支持 javascript、typescript、json、html、css 等；Python 需要安装官方 Python 扩展并启用 python.languageServer（推荐 Pylance）；Go、Rust 等依赖对应语言服务器返回的 FoldingRange 和 DocumentSymbol 数据。
- 没有语言服务器或扩展时，VSCode 只能基于缩进做基础折叠（如 Python 缩进块），但不会识别函数/类为可折叠单元
-
documentSymbol是大纲视图的数据源，缺失该能力的语言（如纯文本、.env）不会显示任何大纲项 - 某些扩展（如 Better TOML）可能只提供语法高亮，不实现折叠或大纲，需查其 README 确认
如何手动触发折叠 / 展开？
快捷键比鼠标更高效，且不受光标位置影响：
-
Ctrl+Shift+[（Windows/Linux）或Cmd+Option+[（macOS）：折叠当前层级 -
Ctrl+Shift+]或Cmd+Option+]：展开当前层级 -
Ctrl+K Ctrl+0：折叠全部区域（含注释、import、函数体等） -
Ctrl+K Ctrl+J：展开全部 - 点击编辑器左侧的
[-]/[+]小箭头仅作用于光标所在行的折叠单元
大纲视图（Outline）为什么为空或不更新？
大纲依赖语言服务器实时解析，常见失效原因包括：
- 文件未保存：部分语言服务器（如 TypeScript）只对已保存文件做完整分析，临时未保存文件可能无大纲
- 工作区未加载语言服务器：检查右下角状态栏是否显示
Python/TS Server等字样，若显示“Starting…”或报错，需等待或重启服务 - 文件关联错误：右键文件标签 →
Change Language Mode→ 确认是正确语言（如 .js 文件被误设为 JSON） - 大纲视图被过滤：侧边栏 Outline 面板顶部有搜索框和筛选图标，可能误点了
Hide symbols not in viewport
自定义折叠区域（#region / #endregion）怎么启用？
VSCode 支持通过注释标记自定义折叠块，但需对应语言配置开启：
- JavaScript/TypeScript：默认启用，写
// #region description和// #endregion即可 - Python：需在
settings.json中添加："python.foldingStrategy": "indentation"
或"python.foldingStrategy": "language-defined"（后者需 Pylance 支持 region） - C/C++、C#：需确认扩展（如 C/C++ 官方扩展、C# for Visual Studio Code）已启用折叠策略，部分版本需手动开启
C_Cpp.enhancedColorization才识别 region - 注意：region 注释必须顶格或仅前面有空白符，不能混用
/* #region */多行注释
真正影响体验的不是开关本身，而是语言服务器是否就绪、文件是否被正确识别、以及 region 语法是否符合当前扩展的解析规则——这些细节一旦出错，折叠和大纲就会“看起来没反应”。
