VSCode代码折叠需按语法层级、手动region标记及快捷键协同使用，并通过扩展和团队配置提升实用性。关键在于服务阅读逻辑与协作效率，而非单纯视觉整洁。
VSCode 的代码折叠功能本身很强大，但真正“有效”取决于你是否用对了方式——不是单纯靠快捷键收起代码，而是让折叠服务于阅读逻辑、协作习惯和调试效率。
理解折叠的触发层级
VSCode 默认按语法结构折叠（如函数、类、if 块、对象字面量），但不会自动折叠注释块或空行分隔区。你可以通过设置控制行为：
-
启用/禁用基于语言的折叠：在设置中搜索
"editor.foldingStrategy"，设为"indentation"可按缩进折叠（适合 Markdown、YAML 或无严格语法的脚本）；默认"auto"更精准但依赖语言支持。 -
手动标记可折叠区域：用
#region和#endregion（JavaScript/TypeScript/Python 等均支持）包裹任意代码段，VSCode 会将其识别为一个折叠单元，适合整理配置项、临时屏蔽逻辑块或归类相似功能。
用快捷键快速导航与切换
光会折叠不够，得能高效操作：
-
折叠/展开当前层级：
Ctrl+Shift+[/Ctrl+Shift+]（Windows/Linux）或Cmd+Shift+[/Cmd+Shift+]（macOS） -
全部折叠/展开：
Ctrl+K Ctrl+0/Ctrl+K Ctrl+J（macOS 同理） -
只折叠注释和空行：先按
Ctrl+K Ctrl+8（折叠所有注释），再配合Ctrl+K Ctrl+1~9指定折叠深度（例如Ctrl+K Ctrl+2折叠到类/函数级）
配合扩展提升实用性
原生功能有时不够细粒度，几个轻量扩展能补上关键缺口：
-
Custom CSS and JS Loader（慎用）：不推荐，有安全风险；更稳妥的是 Fold Plus，支持自定义正则匹配折叠（比如把所有
// TODO:开头的行及后续内容自动折叠） - TODO Tree：虽不直接折叠，但它把所有 TODO 注释聚合成侧边树，相当于“语义化折叠”，避免你在源码里反复滚动找待办
- Indent Rainbow：配合折叠使用，不同缩进层级用颜色区分，一眼识别哪些块已被折叠、哪些还开着，减少误点误展
团队协作中的折叠约定
如果你和同事共用同一套代码，折叠行为最好保持一致：
- 在项目根目录加
.vscode/settings.json，统一配置"editor.foldingStrategy"和"editor.showFoldingControls"（设为"always"确保折叠控件始终可见） - 在 README 或开发文档里写明团队使用的 region 标记规范，例如：
#region ? Utils、#region ? Legacy Code，让折叠标签本身传递意图 - 避免在 PR 中提交大量折叠状态变更（如全文件折叠后 commit），Git 不跟踪折叠状态，但编辑器可能误存 .suo 或 workspace 文件，建议把
**/.vscode/*.json加入.gitignore（除 settings.json 外）
基本上就这些。有效折叠不是为了“看起来干净”，而是让眼睛少走弯路、让思路不被干扰。用熟了，你会发现自己花在滚动和定位上的时间明显变少。
