vscode折叠状态默认不跨会话保存，需通过扩展（auto fold/fold level）或配置"editor.foldlevel"和"foldingstrategy"实现自动折叠；折叠图标消失因"showfoldingcontrols"设为"never"；#region格式必须严格匹配语言规范。
折叠状态默认不保存，每次打开文件都得重新折
VSCode 不会自动记住你上次关闭文件时哪些块是折叠的——这是默认行为，不是 bug。它只在当前会话中维持折叠状态，关掉文件或重启编辑器后全部重置。
如果你依赖折叠结构来导航大型文件，这会明显拖慢启动节奏。解决办法只有两个：
- 装扩展
Auto Fold或Fold Level，它们能在打开文件时按预设层级（比如只展开 class、折掉所有 def）自动执行editor.foldLevel - 手动配置
"editor.foldLevel": 1，配合"editor.foldingStrategy": "indentation"（尤其对 Python 有效），让编辑器一开就按缩进层级收起子级 - 别指望
Ctrl+K Ctrl+0的效果能跨会话留存；它只是临时操作，不写入任何状态
Ctrl+K Ctrl+0 没反应？先查 foldingProvider 是否在线
这个快捷键本质是调用当前语言扩展提供的 foldingProvider 接口。如果接口没返回任何可折叠范围，VSCode 就真的什么也不做——连报错都不会弹。
常见失效场景：
- 右下角语言模式显示
Plain Text或JSONC：这类模式默认无折叠逻辑，点它切回JavaScript或Python - Python 文件里
"python.foldingStrategy": "none"被显式设了：删掉这一行，或改成"auto" - JS/TS 文件装了旧版
ESLint插件，它可能劫持Ctrl+K前缀：打开keybindings.json搜editor.foldAll，确认绑定没被覆盖 - 打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），Console 里搜folding，看到no folding provider就说明扩展没注册折叠能力
折叠控件图标消失，不是功能坏了，是 showFoldingControls 关了
很多人以为折叠功能失灵，其实是视觉反馈被关掉了。VSCode 允许你彻底隐藏左侧的 ▶ / ▼ 折叠图标，只保留快捷键可用——这个设置非常隐蔽，但影响直观判断。
检查和修复方法：
- 设置里搜
showFoldingControls，确保值是"always"或"mouseover"（不能是"never"） - 对应配置项是
"editor.showFoldingControls": "always"，加到settings.json里最稳 - 即使图标显示了，鼠标悬停没预览框？那可能是当前行没被识别为折叠起点——光标必须落在
function、def、{、class这类语法起始行，空行或注释行上不会触发
#region 折叠不生效，格式比内容还重要
VSCode 对 #region 的识别极其严格，不匹配格式就直接忽略，且不报错、不提示。
必须满足的硬性条件：
- JavaScript/TypeScript 用
// #region和// #endregion；Python 用# #region和# #endregion（注意开头是单个#，不是##或/*） -
#endregion必须独占一行，前面最多允许空格，不能跟代码或注释混写 - 漏写
#endregion不会报错，但会导致该#region开始之后的所有合法折叠区域全部失效（包括后续正确的#region） - 确认语言扩展已启用折叠：Python 需
ms-python.python，JS/TS 需ms-vscode.vscode-typescript-next或内置 TS 支持
折叠状态不持久、控件图标消失、#endregion 写错一行就全崩——这些都不是偶然故障，而是 VSCode 折叠机制的设计边界。它不试图“智能猜测”，只响应明确的语法信号和配置开关。
