vscode代码折叠需光标位于可折叠结构起始行（如def/function/{所在行）、语言模式正确且文件已保存；ctrl+shift+[仅向上查找最近起点，空行/注释/字符串内均失效；python需foldingstrategy设为language-defined，#region格式须严格匹配。
VSCode 折叠代码块不是“按了就收”，它依赖光标位置、语言识别和折叠策略三者同时生效。多数人卡在 Ctrl+Shift+[ 没反应，其实问题不在快捷键本身。
Ctrl+Shift+[ 折叠当前块，光标必须落在起始行
这个快捷键只向上查找最近的可折叠结构起点，比如 function、def、if、{ 所在行。光标停在空行、注释后、字符串里或函数体第一行，都会失效。
- 安全做法：把光标放在
def my_func():或function handleEvent() {这类行任意位置再按 - 鼠标悬停在行号左侧出现
▶图标时再按，成功率更高 - Python 用户特别注意：
editor.foldingStrategy若设为indentation，def行可能不被识别为折叠起点，建议保持auto
Ctrl+K Ctrl+0 折叠全部，但只对“已识别结构”生效
它不是强制收起所有缩进块，而是调用语言扩展提供的 foldingProvider，只作用于函数、类、if 块、{} 语句等有明确起止标记的结构。
- 文件必须已保存——未保存的临时文件常不触发语法折叠
- 右下角语言模式必须正确，比如显示
JavaScript而非Plain Text - Python 函数体不折叠？检查是否误设了
python.foldingStrategy:"none"，应改为"language-defined" - 按完没反应？打开命令面板（
Ctrl+Shift+P），输入Fold All看命令是否存在且可点击
#region 手动划折叠区，格式错一个字符就不生效
这不是通用注释，是 VSCode 依赖语言扩展解析的特殊标记。JS/TS 默认支持，Python 需官方扩展且格式严格。
- JS/TS 必须写成
// #region API config，不能用/* #region */ - Python 必须用
# #region utils（开头是#，不是//） - 必须独占一行，前面只能有空白符；
#region和#endregion大小写敏感，不能少空格 - 写漏
#endregion不报错，但该区域之后所有内容都无法折叠（包括后续合法的#region）
折叠状态默认不保存，每次打开都是全展开
VSCode 不记录你上次折叠了哪些块，这是默认行为，不是 bug。想保留状态，得靠扩展或设置干预。
- 确保
editor.foldEnable为true（一般默认开启，但可能被工作区配置覆盖） - 启用
editor.restoreViewState可恢复折叠/滚动位置，但仅对已打开过的文件有效 - 真正可靠的持久化方案是装扩展，如
Restore Code Folding或Auto Fold
最易被忽略的是语言模式和保存状态——哪怕快捷键完全正确，文件没保存或状态栏显示 Plain Text，折叠就根本不会启动。
