VSCode代码折叠卡顿主因是语言服务未识别结构、光标位置错误或折叠策略配置不当；需确保光标位于语法起始行、文件被正确识别为对应语言，且foldingStrategy匹配实际结构。
VSCode 代码折叠卡顿不是性能问题，而是语言服务没识别出结构、光标位置不对，或折叠策略配置失当。
Ctrl+Shift+[ 没反应？先看光标在哪
这个快捷键不会“全局折叠”，它从光标所在行向上扫描，找最近的语法起始行（比如 def、function、{），再折叠整个块。光标落在空行、注释、字符串内部、缩进错位的 Python 行上，就会直接失效。
- 必须把光标放在
def my_func():这行本身，而不是它下面的 docstring 或空行 - JS/TS 中，
const obj = { a: 1 };这种单行对象默认不折叠；得写成多行，且光标停在{那行才生效 - Vue SFC 或 JSX 里的内联
{}默认不支持折叠，需确认对应语言插件已安装并提供了foldingProvider
Ctrl+K Ctrl+0 折不全？检查 foldingStrategy 和语言模式
这个组合键只作用于语言扩展标记为“可折叠”的结构。Python 默认 foldingStrategy 是 auto，但只对 class 和模块级 if __name__ == "__main__" 生效；普通函数体不会被收起。
- 打开设置（
Ctrl+,），搜foldingStrategy，把 Python 文件设为indentation，Ctrl+K Ctrl+0才能稳定折叠所有def块 - 右下角状态栏必须显示
Python，不是Plain Text；否则连折叠图标都不出现 - JS/TS 推荐保持
auto，靠语法树识别更准；切到indentation反而可能把单行if (x) return;当成独立块过度折叠
折叠图标太小或颜色难辨？别改主题，只调 CSS 片段
VSCode 默认折叠箭头是浅灰小三角，在高分辨率屏或深色主题下极易忽略。这不是 bug，而是主题配色与 UI 缩放共同作用的结果。
- 不改主题，只通过
settings.json注入 CSS 片段（需启用workbench.colorCustomizations） - 添加如下配置：
"workbench.colorCustomizations": { "editor.foldBackground": "#2a2a2a", "editorGutter.foldingControlForeground": "#8be9fd" } -
editor.foldBackground设置的是折叠区域左侧背景色（仅当启用editor.showFoldingControls: "always"时可见）
想持久记住折叠状态？原生不支持，得靠 #region
VSCode 默认不保存折叠状态，每次打开都是全展开。这不是 Bug，是设计如此——尤其对大文件或多人协作项目，避免状态污染。
- 唯一可靠方式是手动加
// #region和// #endregion（JS/TS/Python 都支持） - 折叠后状态会随文件保存，下次打开仍保持收起
- 注意：
Inline Fold插件这类纯视图层压缩方案，光标一进入就自动展开，无法替代#region
最常被忽略的一点：折叠流畅度和你是否禁用了某语言扩展的语法服务无关，而取决于当前文件是否真正被识别为该语言、光标是否落在可触发折叠的语法锚点上、以及 foldingStrategy 是否匹配实际结构特征——三者缺一不可。
