VSCode代码折叠需语言识别、扩展支持和设置三者协同；快捷键仅对光标所在有效结构生效，语言模式、foldingStrategy、showFoldingControls等配置错误或扩展缺失均会导致失效。
VSCode 里代码折叠不是“按了就一定有效”，它依赖语言识别、扩展支持和设置三者同时在线。快捷键失效、区域不响应、折叠图标消失，基本都能归因到这三类问题中的某一个。
Ctrl+Shift+[ 没反应？先确认光标在可折叠结构内
这个快捷键只对「当前光标所在的有效折叠区域」起作用，不是全局命令。常见错误是光标停在空行、注释末尾或纯文本段落里——这些位置没有语法边界，VSCode 根本不认为它是可折叠块。
- 把光标移到
function关键字上、if语句的大括号内、class声明行，再按Ctrl+Shift+[ - 右下角状态栏检查语言模式：显示
Plain Text或JSONC时，很多结构默认不可折；点击它手动切为JavaScript、Python等对应语言 - HTML 文件中，
<div>标签必须成对且嵌套正确，否则折叠控件不会出现
Ctrl+K Ctrl+0 折叠全部但没效果？检查 foldingStrategy 和扩展状态
Ctrl+K Ctrl+0 看似一键解决，实则最易被底层配置卡住。它不靠“猜”，而是调用语言扩展提供的 foldingProvider 接口，如果接口没返回任何折叠范围，就真的什么也不做。
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切换到 Console 标签页，搜索folding—— 若看到no folding provider类报错，说明当前语言扩展未实现折叠逻辑 - 检查
settings.json中是否误设了"editor.folding": false或"editor.foldingStrategy": "never" - Python 文件若设了
"python.foldingStrategy": "none"，哪怕有函数也不会折叠；改为"auto"或删掉这一项即可恢复
#region 折叠不生效？注意注释格式和语言扩展兼容性
手动折叠区域是跨语言的兜底方案，但 VSCode 对 #region 的识别非常严格，不匹配就直接忽略，连警告都不给。
- JS/TS 必须写成
// #region utils，不能是/* #region */或// #region后面没空格加文字 - Python 同样支持
#region，但前提是安装了官方ms-python.python扩展，且没禁用折叠功能 -
#endregion必须独占一行，前面最多允许空格，不能跟其他代码或注释混写 - 写漏
#endregion不会报错，但会导致该#region之后所有内容都无法被折叠（包括后续合法的#region）
鼠标悬停预览空白、折叠图标消失？其实是 showFoldingControls 被关了
很多人以为折叠功能坏了，其实是视觉反馈被隐藏了。VSCode 允许你完全关闭左侧折叠控件的显示，只保留快捷键可用——这个设置很隐蔽，但影响极大。
- 搜设置项
editor.showFoldingControls，确保值是"mouseover"或"always"，而不是"never" - 即使设置了
"mouseover"，也要把鼠标真正移到行号区左侧空白处（不是数字上），悬停 200ms 左右才会浮现 ▶ 图标 - 预览内容为空白？说明被折叠的代码块太长或含非法字符（如未闭合的字符串、BOM 头），VSCode 放弃渲染预览以保性能
最常被忽略的一点：折叠行为不会自动随代码变更刷新。改完函数结构或增删大括号后，别指望图标立刻更新——得手动触发语言服务重启，比如运行 Developer: Restart Language Server，否则旧的折叠范围可能还挂在那儿。
