VSCode代码折叠默认支持函数、类等结构，触发方式包括点击箭头、快捷键Ctrl+Shift+[ / ]或右键；大纲视图依赖语言服务器，需正确配置语言模式和扩展。
代码折叠怎么触发，哪些区域能折
VSCode 默认对函数、类、条件块、循环体、注释块等支持自动折叠，但不是所有语法结构都默认可折——比如 if 块在 JavaScript 中可折，但在某些旧版 TypeScript 配置下可能失效；for 和 while 通常没问题，但单行语句（如 if (x) doSomething();）不会生成折叠区域。
手动触发方式有三种：
– 点击行号左侧的 ▶ 小箭头
– 快捷键：Ctrl+Shift+[（折叠）、Ctrl+Shift+]（展开）
– 右键选择「Fold」或「Unfold」
容易忽略的点：
– 折叠状态不跨会话保存，重启 VSCode 后恢复展开
– 自定义折叠区域需用 // #region 和 // #endregion 注释标记（支持任意语言，但需开启 "editor.foldingStrategy": "indent" 或默认的 "syntax"）
– 在 settings.json 中设 "editor.showFoldingControls": "always" 可让折叠控件始终显示，避免找不到入口
大纲视图（Outline）为什么看不到函数或符号
大纲视图依赖语言服务器（LSP）提供符号信息，不是所有语言开箱即用。例如：Python 需装 Pylance 或 Python 官方扩展；Go 需 gopls 正常运行；而纯文本或未配置 languageId 的文件（如无后缀的脚本）根本不会出现大纲。
常见原因和对策：
– 文件没被识别为对应语言：检查右下角语言模式，点击切换，或用快捷键 Ctrl+K Ctrl+M 手动指定
– 扩展未启用或崩溃：打开命令面板（Ctrl+Shift+P），运行 Developer: Toggle Developer Tools，看 Console 是否报 LSP 连接失败
– 符号层级太深：大纲默认只显示顶层符号（如导出的函数/类），内部函数、变量、常量默认不列，无法通过设置强行展开
– 文件过大或解析超时：VSCode 会在状态栏显示「Loading symbols…」，此时可稍等，或关闭其他大文件释放资源
如何让自定义代码块出现在大纲里
标准大纲只识别语言规范定义的符号（如 function、class、export），不支持用户随意标注。但有两个实用变通方式：
– 使用 JSDoc 注释 + 支持符号提取的扩展（如 TSDoc 或 Document This）可让注释块带名称出现在大纲，但本质仍是“文档节点”，非可跳转代码位置
– 在支持 #region 的语言中（如 TypeScript），虽然 // #region MySection 不会进大纲，但配合扩展 TODO Highlight 或自定义正则，可在「Explorer」中用搜索定位，算间接补充
真正可靠的方式只有一种：确保函数/类有合法声明语法，并被语言服务器正确索引。比如：
– 错误写法：const handler = () => { ... };（箭头函数赋值，部分 LSP 不视为可导出符号）
– 推荐写法：export function handler() { ... } 或 export class Handler { ... }
折叠与大纲共用时的典型冲突场景
最常遇到的是：折叠某函数后，大纲里该函数仍高亮，但点击无法跳转到代码——因为折叠后目标行不可见，VSCode 会静默失败，不报错也不提示。
实际影响：
– 搜索符号后按 Enter 跳转失败，光标停在原地
– 使用 Ctrl+G 输入行号跳转时，若目标行被父级折叠包裹，同样跳不过去
– 大纲中双击类名，若其 constructor 或方法被折叠，只会展开到类一级，不会进一步展开内部
应对建议：
– 查找符号前先执行 Ctrl+Shift+[ 全部展开（或用 Ctrl+K Ctrl+0）
– 在设置中启用 "editor.unfoldOnClickAfterEndOfLine": true，点击行尾空白处自动展开当前折叠块
– 不要依赖大纲跳转做高频操作；对关键函数，用 Ctrl+Shift+O（转到符号）更稳定，它会在弹窗中预览上下文，且支持模糊匹配
