vscode折叠需光标位于可识别结构内，如function/def行；全折命令依赖文件保存、语言服务加载及语法支持；#region标记须严格格式；折叠状态默认不保留，需手动启用restoreviewstate。
为什么光标放对位置，Ctrl+Shift+[ 才能折函数体
VSCode 不是“按一下就收起整个函数”，它只折叠光标当前所在的「可识别折叠区域」。如果光标停在 function 关键字那行、或 { 行、或函数体第一行的代码上，Ctrl+Shift+[ 才大概率触发函数级折叠；停在空行、注释行、或 } 后面，就可能什么也不发生。
常见错误现象：
- 点了没反应 → 光标不在可折叠结构内部
- 只折了 if 块，没折外层函数 → 光标实际落在 if 内部，编辑器优先响应最近的嵌套块
- Python 文件里
def折不动 → 语言模式没识别成 Python，或"editor.foldingStrategy"被设成了"indentation"（该策略不识别def语法边界）
实操建议：
- 把光标移到
function/def/class所在行，再按Ctrl+Shift+[ - 确认右下角语言模式显示正确（如
JavaScript，不是Plain Text） - 检查
settings.json中是否误删了"editor.foldingStrategy": "auto"（推荐值，非indentation）
Ctrl+K Ctrl+0 折不了全部？先看这三件事
Ctrl+K Ctrl+0（macOS 是 Cmd+K Cmd+0）确实是“一键全折”的命令，但它依赖三个前提同时成立：文件已保存、语言服务已加载、当前语言支持语法级折叠。JSON、HTML、YAML 等无作用域结构的文件，默认就不响应这个快捷键。
使用场景：
- 适合 TypeScript/JavaScript/Python/C# 等有完整语言服务的文件
- 不适合未保存的临时文件（.txt 或无后缀粘贴内容），因为语言服务无法启动
- 在大型配置对象中失效？可能是对象字面量没被识别为可折叠单元——这时得靠
// #region
实操建议：
- 保存文件后再试
Ctrl+K Ctrl+0 - 打开命令面板（
Ctrl+Shift+P），输入Fold All，看是否列出该命令；没列出说明当前语言禁用了折叠 - 遇到 JSON 或 Markdown 配置块，直接跳到手动标记方案
用 // #region 创建折叠区，但折叠图标没出现？
// #region 和 // #endregion 是 VSCode 原生支持的折叠标记，不需要插件，但对格式极其敏感：必须是单独一行、以 // 开头、后面紧跟空格和 #region（大小写必须一致），且不能混在其他语句里。
容易踩的坑：
-
//#region（缺空格）→ 不识别 -
/* #region */（用块注释）→ 不识别 -
// #region和// #endregion之间有未闭合的{或"→ 整个区域静默失效，无报错提示 - 写了
// #region但漏了// #endregion→ 后续所有代码都被吞进一个无限折叠区，直到文件末尾
实操建议：
- 复制粘贴时确保换行独立：
// #region 初始化配置 const config = { ... }; // #endregion - 标题可选但推荐加，比如
// #region API 请求封装，折叠后左侧箭头旁会显示文字 - 在 JSX 或 Vue 单文件组件中同样有效，但不要放在
<template></template>标签内（HTML 解析器不处理 JS 注释）
折叠状态不保留？不是 bug，是默认行为
VSCode 默认不会记住你上次折叠了哪些区域，每次重新打开文件，所有代码都是展开态。这不是设置遗漏，而是设计如此——除非你装了扩展（如 Auto Fold），或手动启用了视图状态恢复。
性能与兼容性影响：
- 启用
"workbench.editor.restoreViewState": true可恢复折叠状态，但会略微拖慢大文件打开速度 - 某些远程开发场景（SSH、Dev Container）下，该设置可能被覆盖，需在远程 settings.json 中单独配
- 多人协作时，折叠状态属于本地 UI 状态，不随 Git 提交，也不影响 LSP 功能
真正容易被忽略的地方是：你花时间调好了折叠结构，结果第二天打开全展开了——这不是编辑器坏了，是它压根没打算记。如果项目里大量依赖 #region 分组，建议顺手开一下 restoreViewState，否则每次都要重点一遍。
