VS Code代码折叠需语言服务正常，快捷键为Ctrl+Shift+[（Win/linux）或Cmd+Option+[（macos）；Outline面板基于AST实现精准符号导航，二者协同提升大型文件浏览效率。
代码折叠的触发方式和快捷键
VS Code 默认对函数、类、注释块、条件语句等结构自动启用折叠，但前提是语言服务正常工作。如果 Ctrl + Shift + [（windows/Linux）或 Cmd + Option + [（macOS）没反应，先检查当前文件是否被识别为正确语言模式（右下角显示如 javaScript 而非 Plain Text）。
常见失效原因包括：
- 文件未保存，且未设置
"files.autoSave": "onFocusChange" - 扩展冲突（如某些语法高亮插件禁用了折叠支持）
- 自定义折叠区域未启用：需在
settings.json中添加"editor.foldingStrategy": "indent"或"syntax"（推荐"syntax"，更准确）
手动创建折叠区域可用 // #region 和 // #endregion（支持 javascript/typescript/python/C# 等），VS Code 会将其识别为可折叠块。
轮廓图（Outline）面板的实用技巧
Outline 面板（Ctrl + Shift + O 或侧边栏图标）依赖语言服务器提供符号信息。它不是简单按缩进或关键词提取，而是基于 AST 解析，所以准确性远高于“大纲”式正则匹配。
高效用法包括：
- 输入符号名快速跳转（如输入
useEffect直接定位到该 Hook 定义处） - 右键符号可选择「复制位置」或「在文件中查找所有引用」
- 勾选面板顶部的
▶按钮可展开全部节点，适合初次浏览结构 - 若 Outline 为空，大概率是语言服务器未启动——检查 VS Code 右下角状态栏是否有
Initializing JS/TS language features...，或尝试重载窗口（Ctrl + Shift + P→Developer: Reload Window）
大型文件卡顿时的替代方案
当单个文件超 10MB 或含数千行嵌套结构时，折叠和 Outline 可能响应迟缓甚至无响应。这不是 bug，而是语言服务主动降级的结果。
可尝试以下缓解方式：
- 关闭不必要的扩展，尤其「Prettier」「ESLint」等实时校验类插件（它们会在后台持续解析）
- 在
settings.json中设置"javascript.suggestionActions.enabled": false和"typescript.suggestionActions.enabled": false，减少后台符号计算压力 - 用
Ctrl + G输入行号直接跳转，比滚动更快；配合Ctrl + F搜索function或class（注意空格）快速定位顶层声明 - 临时切换语言模式为
Plain Text再切回，有时能重置折叠状态
折叠与 Outline 的协同使用场景
真正提升大型文件浏览效率的，是把两者当作互补工具：折叠用于「局部收放」，Outline 用于「全局定位」。
例如在阅读一个 2000 行的 react 组件时：
- 先用 Outline 找到
useMemo相关逻辑块，点击跳转 - 到达后，用
Ctrl + Shift + [折叠掉不相关的useEffect或事件处理函数，聚焦当前关注段落 - 再回到 Outline，搜索
render快速跳到返回 JSX 的位置，避免滚动找 return
注意：Outline 不显示被折叠的子节点，但它始终反映完整 AST 结构——折叠只是视觉操作，不影响符号索引。这点常被忽略，导致误以为「折叠后 Outline 就找不到里面的方法了」。