Ctrl + . 折叠快捷键仅对可折叠语法节点有效，如函数体、if块、{}对象等；失效常见于纯表达式行、空行、中文输入法、UTF-8 BOM编码、未启用JSX/TS折叠选项；需手动开启Settings中XML tag contents、TypeScript类型及import折叠支持；// region可手动锚定折叠区域，配合Ctrl + Shift + .逐层展开。
Ctrl + . 为什么光标一放就失效
这个快捷键不是“选中才生效”，而是严格依赖光标所在语法节点的可折叠性。它只对有明确起止边界的结构有效，比如 function 函数体、if 块、{} 对象字面量、class 定义内部——光标停在 function 关键字后、if (x) { 的大括号内、或 JSX 标签内部任意位置，按一次就能收起整个块。
常见失效场景：
- 光标落在纯表达式行（如
return true;、const x = 1;）或空行上，Ctrl + .完全无响应 - 用了中文输入法或非英文键盘布局，
.键被系统拦截，切英文输入法再试 - 文件是 UTF-8 with BOM 编码，导致
// region类注释解析失败 - JSX 元素、TS 类型定义（如
type Foo = {...}）、import语句默认不折叠，得手动开启对应选项
JSX 和 TypeScript 类型不折叠？去 Settings 开关
WebStorm 默认关闭了 JSX 和 TS 特有结构的折叠支持，这不是 bug，是策略性关闭。必须手动启用：
- 进
Settings > Editor > General > Code Folding - 勾选
XML tag contents（覆盖 JSX 元素） - 勾选
TypeScript interfaces and type aliases（支持interface/type） - 如需折叠所有
import，额外勾选Import statements
改完不用重启，但已打开的文件标签页要右键 → Fold All 才能立刻看到效果。注意：带复杂泛型约束的类型定义（如 type X<t extends record unknown>> = ...</t>）仍可能无法折叠，这是解析器限制，非设置问题。
想折哪折哪：用 // region 手动锚定
当语法结构不支持自动折叠，或你只想临时隐藏一段调试逻辑、多版本分支、大段配置对象时，// region 是最可靠的手动方式：
-
// region必须独占一行，且后面紧跟一个空格，不能有其他字符（// region API handlers✅，//region或// region:❌） - 选中代码 → 按
Ctrl + .→ 选Fold Selection，比写注释更快 - 折叠后左侧出现小箭头，悬停显示描述文字，点一下即可展开
- 跨函数、含空行和注释的混合块也能折叠，但若横跨多个不连续语法节点（比如函数+独立
export），WebStorm 可能拒绝处理
嵌套太深时，别狂点小箭头
在 useEffect 套 useState 套 Promise 的 5 层嵌套里，靠鼠标点折叠标记效率极低。真正快的是：
- 把光标移到已折叠的那行（比如显示
12 lines的标记行），按Ctrl + Shift + .—— 这是「逐层展开」专用键，连按多次，一层一层往外展 -
Ctrl + Shift + -折叠全部，Ctrl + Shift + +展开全部，但注意：+是主键盘上方的加号（Shift + =），不是小键盘加号；笔记本用户常需配合Fn键 - 按住
Alt再点折叠箭头，会递归折叠/展开子块（比如点一个class名，连带里面所有方法都收起）
自定义 // region 同样支持 Ctrl + Shift + . 逐层展开，但 JSX 内联表达式（如 {items.map(...)}）即使写了 // region，也可能因解析限制无法生效。
