vscode默认折叠快捷键为ctrl+shift+[（折叠）和ctrl+shift+]（展开），macos对应cmd+option+[与cmd+option+]；需确保光标位于可折叠结构内且语言模式正确识别。
VSCode 默认代码折叠快捷键是什么
默认情况下，Ctrl+Shift+[ 折叠当前层级，Ctrl+Shift+] 展开。注意：不是所有语言都默认支持——比如纯 .txt 或未启用语法高亮的文件，连折叠图标都不会显示。
常见错误现象：按了快捷键没反应，其实是光标没落在可折叠结构内（如函数、类、注释块、JSON 对象），或者当前语言模式没被 VSCode 识别（右下角状态栏检查是否显示 Plain Text 而非 JavaScript 等）。
- Windows/Linux 用
Ctrl+Shift+[/Ctrl+Shift+]；macOS 是Cmd+Option+[/Cmd+Option+] - 折叠粒度由语言扩展决定：Python 靠缩进，JS 靠大括号，HTML 靠标签对，JSON 靠花括号和方括号
- 鼠标悬停在行号左侧的空隙会出现小箭头，点它比快捷键更直观，尤其适合不确定是否可折叠时
怎么让自定义区域也能折叠（比如大段注释或配置块）
VSCode 支持用特殊注释标记折叠区域，但必须满足两个条件：语言扩展支持 foldingStrategy: "indent" or "auto"，且注释格式符合约定。最通用的是 // #region 和 // #endregion，适用于 JS/TS/Python（需加 # 前缀）等。
常见错误现象：写了 #region 却不生效，大概率是当前文件类型没加载对应语言服务（比如 .js 文件被误设为 Plain Text），或用了不被识别的变体（如 /* region */ 在 JS 中无效）。
- JS/TS 推荐写法：
// #region API config+// #endregion - Python 同样可用，但需确保安装了官方 Python 扩展，且
"python.foldingStrategy"没被设为none - 不建议混用：VSCode 不识别
/* #region */这种多行写法，只认单行注释开头的#region - 折叠区域支持嵌套，但最多到 5 层，再深可能触发渲染异常
为什么有些 JSON 或 HTML 文件无法折叠
JSON 和 HTML 的折叠依赖语法解析器是否启用。VSCode 默认对 .json 开启折叠（基于括号匹配），但对 .jsonc（带注释的 JSON）或某些自定义后缀（如 .config.json）可能失效；HTML 则要求文档有正确 结构，否则只当普通文本处理。
常见错误现象：“JSON 折叠图标消失”“<script></script> 块内 JS 不折叠”——本质是语言模式错配或嵌入内容未被子语言识别。
- 检查右下角语言模式是否为
JSON（不是JSON with Comments或Plain Text） - HTML 中内联 JS/CSS 不会自动继承折叠逻辑，得靠语言插件（如
Auto Close Tag或JavaScript (ES6) code snippets）增强支持 - 大文件（>5MB）可能禁用折叠以保性能，此时状态栏会提示 “Folding disabled for large files”
- 可通过设置
"editor.foldingMaximumRegions"调整上限，默认 5000，设太高反而卡顿
折叠相关设置容易被忽略的关键项
真正影响体验的不是快捷键，而是几个隐藏较深的配置项。它们不常被修改，但一旦出问题，所有折叠行为都会异常。
最容易被忽略的是 "editor.showFoldingControls"——设为 mouseover 时，折叠按钮只在鼠标悬停行号区才出现，新手常以为“功能坏了”。另一个是 "editor.folding"，若被插件或工作区设置关掉，快捷键完全失效。
-
"editor.folding": true—— 全局开关，务必开启 -
"editor.showFoldingControls": "always"—— 推荐设为 always，避免找不到折叠入口 -
"editor.foldingStrategy": "auto"—— 比indent更智能，能识别语言特有结构（如 Python 的if/def块） - 工作区设置（
.vscode/settings.json）会覆盖用户设置，排查时优先看这里有没有"editor.folding": false
折叠不是“开了就完事”的功能，它和语言服务、文件模式、性能阈值紧密耦合。一个 #region 不生效，可能要顺着“语言模式→扩展启用→配置项覆盖→文件大小”这条链路查四层。
