vscode代码折叠需同时满足光标位于可折叠结构起始行、语言模式正确、foldingstrategy设置合理及语言扩展启用折叠能力；ctrl+shift+[仅作用于光标向上最近的function/class/def/{等语法行，非全局命令；ctrl+k ctrl+0依赖文件保存、正确语言模式和foldingprovider支持；#region需严格格式且扩展支持；折叠状态默认不保存。
VSCode 折叠代码块不是“按了就有效”，它必须同时满足：光标落在可折叠结构起始行、语言模式正确识别、foldingStrategy 设置合理、对应语言扩展已启用折叠能力——缺一不可。
Ctrl+Shift+[ 没反应？先看光标在哪一行
这个快捷键只对「光标所在行向上最近的可折叠结构」生效，不是全局命令。它不会猜你想折哪，只会找 function、class、def、if、{ 这类语法起始行。
- 常见失效场景：光标停在空行、单行注释末尾、字符串内部、或
def my_func():的下一行（哪怕只差一行） - 安全做法：把光标放在
def/function/class所在行任意位置，再按Ctrl+Shift+[ - 鼠标悬停在行号左侧出现 ▶ 图标时再按，成功率更高；没图标说明 VSCode 根本没识别出结构
- Python 用户特别注意：
editor.foldingStrategy若设为indentation，def行可能不被识别为折叠起点，建议保持auto或改用language-defined
Ctrl+K Ctrl+0 折叠全部，但为什么有些函数还在展开？
Ctrl+K Ctrl+0 只作用于语言扩展明确标记为“可折叠”的结构，不是所有代码块都默认支持。它依赖三个前提同时成立：
- 文件已保存（未保存的临时文件可能不触发语法折叠）
- 右下角语言模式显示正确（如
JavaScript，不是Plain Text） - 当前语言的
foldingProvider已启用（例如 Python 需要官方ms-python.python扩展） - Python 函数体不折叠？检查
settings.json是否误设了"python.foldingStrategy": "none"，删掉或改为"language-defined"
想手动划出折叠区？#region 格式错一个字符就不生效
#region 不是万能标签，它需要语言扩展支持且格式极其严格。VSCode 不校验配对，写漏 #endregion 会导致后续所有内容无法折叠。
- JS/TS 必须写成
// #region API config，不能用/* #region */ - Python 同样支持，但必须用
# #region utils（开头是#，不是//） - 必须独占一行，前面只能有空白符；后面紧跟空格和
#region（大小写敏感） - 嵌套最多到 5 层，再深可能触发渲染异常
- 写漏
#endregion不报错，但该#region之后所有内容都无法被折叠（包括后续合法的#region）
折叠状态默认不保存，每次打开都是全展开
VSCode 默认不记住你上次折叠了哪些块。如果你依赖固定结构（比如只看类名、跳过实现细节），仅靠快捷键不够可靠。
- 真正可控的方式是配合
// #region标记关键逻辑块，它们会在每次打开时保持折叠态（前提是扩展支持且格式正确） - 若需恢复折叠状态，可安装扩展如
Restore Code Folding，或手动启用"editor.restoreViewState": true - 大文件（>5MB）可能禁用折叠以保性能，此时状态栏会提示 “Folding disabled for large file”
