VSCode折叠错乱源于语言服务器未正确返回foldingRange，而非代码或设置问题；需重启语言服务、检查扩展冲突、清理缓存或排查非法语法。
折叠错乱不是代码写错了，而是 VSCode 没正确解析出代码块边界 —— 本质是语法结构识别失败，不是快捷键或设置开关的问题。
为什么折叠位置偏移、多折一层或漏掉函数？
VSCode 的折叠依赖语言服务器返回的 foldingRange（折叠范围），而非简单匹配括号或缩进。一旦语言服务未就绪、响应异常或返回了错误的行号/列号，折叠控件就会插在错的地方，比如：
- 函数体被切成两段折叠，或整个
if块没出现在折叠列表里 - 光标在第 15 行按
Ctrl+Shift+[，结果第 8 行的for块被折叠了 - 刚保存后折叠图标“跳”了一下，和之前不一致
常见诱因包括：TS Server 卡住、Pylance 初始化失败、远程容器中语言服务未启动、或文件含非法语法（如 JSON 中的注释）导致解析器提前终止。
如何强制重载语法解析并刷新折叠范围？
别重启窗口或重装插件 —— 直接触发语言服务重新计算折叠信息：
- 确保文件已保存（
Ctrl+S），未保存的临时文件不会触发完整语义解析 - 执行命令面板（
Ctrl+Shift+P），输入并运行：Developer: Restart Language Server（对 TS/JS/Python 等有效） - 若该命令不存在，改用：
Developer: Reload Window（比关再开快，且保留所有编辑状态） - 对远程开发（SSH/Dev Container），先确认右下角显示
Connected，再操作；否则折叠只走indentation回退逻辑，必然错乱
检查折叠范围是否真被语言服务提供？
打开开发者工具（Ctrl+Shift+I），切到 Console 标签页，粘贴执行：
monaco.editor.getLanguages().find(l => l.id === monaco.editor.getModel(monaco.editor.getModels()[0]).getLanguageId()).foldingRules
如果返回 undefined 或 {}，说明当前语言扩展没注册折叠规则 —— 这时折叠完全靠 editor.foldingStrategy: "indentation" 硬凑，必然错乱。此时应：
- 确认已安装对应语言扩展（如 Python 文件必须有
ms-python.python或ms-python.pylance） - 检查扩展是否启用：命令面板搜
Extensions: Show Enabled Extensions，过滤语言名 - 禁用冲突扩展（如旧版
python扩展与pylance共存时会抢折叠控制权）
折叠错乱但其他功能正常？优先怀疑缓存污染
VSCode 会缓存语言服务的 AST 和折叠映射，大项目或频繁切换分支后容易残留脏数据：
- 关闭当前工作区，执行：
code --disable-extensions --user-data-dir=/tmp/vscode-test（Linux/macOS）或code --disable-extensions --user-data-dir="%TEMP%\vscode-test"（Windows） - 用这个干净环境打开同一文件，测试折叠是否恢复正常
- 若恢复，说明原用户数据目录（
$HOME/Library/Application Support/Code或%APPDATA%\Code）里有损坏的 workspace state 或 language server 缓存 - 不建议手动删整个目录 —— 可针对性清空：
Workspaces/*/workspace.json和Cache/semantic-tokens/下内容
折叠错乱最常被忽略的一点：它往往只发生在特定文件或特定代码段，而不是全局失效。这意味着问题不在设置，而在那一段代码触发了语言服务的边界 case —— 比如一个未闭合的模板字符串、嵌套过深的泛型类型、或注释里意外出现的 {。查的时候别只盯设置，要盯那几行“看起来没问题”的代码。
