VSCode 默认不折叠 JavaScript/TypeScript 的 if/for 等代码块，因其依赖语言服务器提供的折叠范围，而 TS Server 对无大括号的控制流语句（如 if (x) stmt;）不识别为可折叠区域；需使用 {} 显式作用域、启用 "editor.foldingStrategy": "indentation" 或 // #region 手动标记。
VSCode 默认不折叠 JavaScript/TypeScript 的 if/for 等代码块
VSCode 默认只对 function、class、if（仅当有 {} 且被识别为作用域）等语法结构做自动折叠，但实际中常遇到 if 或 for 块没折叠、或者折叠后展开又自动收回去的问题。根本原因是：VSCode 折叠依赖语言服务提供的「folding ranges」，而默认的 JS/TS 语言服务器（TypeScript Server）对控制流语句的折叠支持较弱，尤其当没有显式大括号、或存在嵌套注释/空行时，getFoldingRanges 可能直接跳过。
实操建议：
- 确保代码使用标准大括号风格，例如
if (x) { console.log('yes'); }而非if (x) console.log('yes');—— 后者不会被识别为可折叠区域 - 在
settings.json中启用更激进的基于缩进的折叠（临时补救）："editor.foldingStrategy": "indentation"，但它会把所有同缩进块都当候选，可能误折叠注释或字符串内的换行 - 安装插件
indent-rainbow或Bracket Pair Colorizer辅助肉眼判断缩进层级，避免因空格/tab混用导致折叠失效
手动创建自定义折叠区域（#region / #endregion）
这是最可控、跨语言通用的方式，尤其适合隐藏配置对象、长条件判断、重复初始化逻辑等「非语法块」内容。VSCode 原生支持 #region 和 #endregion 注释标记，无需额外插件。
实操建议：
- JavaScript/TypeScript 中写法必须是单行注释：
// #region 初始化配置和// #endregion；多行注释/* #region */不生效 - Python 用户需改用
#region和#endregion（注意不是##region），并确认已安装Python官方扩展（v2021.9+ 支持） - 折叠区域可嵌套，但 VSCode 不显示嵌套层级指示器，容易点错 —— 建议命名带层级提示，如
// #region ▸ API 请求参数 - 若折叠后无法展开，检查是否漏写了
#endregion或拼写错误（大小写敏感），错误日志不会报出，只会静默忽略整段
快捷键触发与常见误操作
折叠/展开的快捷键本身简单，但组合场景下容易按错或预期不符。Windows/Linux 默认是 Ctrl+Shift+[ / Ctrl+Shift+]，macOS 是 Cmd+Shift+[ / Cmd+Shift+]，但很多人实际按的是 Ctrl+K Ctrl+[（旧版快捷键，现已被弃用）。
实操建议：
- 用
Ctrl+K Ctrl+S（打开快捷键面板）搜索folding，确认当前绑定 —— 某些键盘布局（如日文/韩文输入法激活时）会导致[键映射异常 - 光标位置影响行为：在折叠区域内任意位置按
Ctrl+Shift+[，会折叠该区域；在空白行或注释行按，可能折叠上一个有效块，也可能无反应 - 想快速折叠全部，用
Ctrl+K Ctrl+0；但注意它也会折叠 import 块和文档注释，后续恢复时得逐级Ctrl+K Ctrl+J，不能一键全展 - 鼠标悬停在行号左侧的折叠控件上，会显示折叠范围预览（含行数），但若代码太长或字体太小，这个提示极难看清，别依赖它判断是否真折叠成功
为什么改了 settings.json 还不生效？
最常见的原因是语言模式未正确识别。VSCode 折叠能力严格绑定当前编辑器右下角显示的语言模式（如 JavaScript、Plain Text），哪怕文件后缀是 .js，如果状态栏显示 Plain Text，editor.foldingStrategy 设置完全无效。
实操建议：
- 点击右下角语言标识，选择对应语言（如
JavaScript），或按Ctrl+K M快速切换 - 检查文件是否被
files.associations错误映射，例如误将*.config.js关联到jsonc，导致 JS 折叠规则不加载 - 重启 VSCode 窗口（不是重载窗口）—— 语言服务器启动后才读取折叠策略，热更新设置不触发重载
- 某些远程开发场景（SSH/WSL），本地设置同步过去但服务端插件未安装，折叠功能会降级为纯缩进模式，此时
#region也不起作用
折叠逻辑藏在语言服务器和编辑器渲染层之间，看起来只是点一下箭头，背后涉及语法分析、范围计算、DOM 更新三步。一旦某环断开（比如 TS Server crash、插件冲突、GPU 渲染异常），就只剩空白三角图标，连 hover 提示都没了。
