vscode 折叠功能依赖可折叠节点识别，空行、注释行无响应；需光标位于 def/if/function/{ 等结构行，且语言模式正确、缩进一致、foldingstrategy 设置合理，手动 region 标记需格式严格并启用对应设置。
Ctrl+Shift+[ 折叠光标所在语法块，不是所有代码行都响应——必须落在 def、if、function、{ 这类有结构意义的行上，否则快捷键无反应。
为什么光标在空行或注释行按 Ctrl+Shift+[ 没反应
VSCode 折叠逻辑依赖“可折叠节点”的识别，空行、纯注释、字符串内换行都不构成节点。常见误操作包括：
- 光标停在
// TODO: xxx行——这类单行注释不触发折叠，需移到上方的function或if行 - Python 中缩进不一致（混用空格和 Tab）——导致编辑器无法判断块边界，
def后的整个函数体可能不显示折叠箭头 - 文件被识别为
plaintext而非python或javascript——右下角语言标识错误，折叠功能退化为仅响应缩进，且不稳定
editor.foldingStrategy 设为 indentation 还是 auto
两者行为差异明显，选错会导致 Python 函数不折叠、JSX 内联表达式无法收起：
-
auto（默认）：依赖语言服务器返回的FoldingRange，对function、class、import块识别准，但 Python 的 docstring 和三引号字符串默认不折叠 -
indentation：强制按缩进层级折叠，适合 Python/Ruby/Shell，能收起def下所有缩进段，但会丢失语义级控制（比如点击函数名不能一键收起整个函数体） - TypeScript/JSX 需额外启用
editor.showFoldingControls: "always"才能在{}内联表达式旁显示折叠控件
用 // #region 手动创建折叠区，但没生效
手动标记不是写完就自动可用，需确认三个条件同时满足：
- 语言模式支持：JavaScript、TypeScript、Python、C# 等主流语言原生支持；SQL、YAML、JSON 不支持，除非装了对应插件
- 设置开启：在
settings.json中确保"editor.folding": true且"editor.foldingIncludeRegions": true - 格式严格：必须是
// #region（JS/TS）或#region（Python），不能多空格、不能写成//#region（少空格）或//# region（空格错位）
Ctrl+K Ctrl+J 展开全部，但部分区域仍收着
这个快捷键只展开“已被折叠”的区域，不会还原被手动关闭的折叠控件状态，也不影响未触发过折叠的块。真正容易被忽略的是：
- 折叠状态默认不保存：关掉文件再重开，之前收起的函数会自动展开——这不是 bug，是 VSCode 默认行为；如需保留，得装扩展（如
Restore View State）或设"workbench.editor.restoreViewState": true - 大纲视图（Outline）中右键某函数 →
Fold All Others，这种折叠是独立于编辑器主视图的，Ctrl+K Ctrl+J对它无效 - HTML 文件里
<script></script>标签内的 JS 代码，若语言模式是html而非javascript，其内部function块可能根本不参与折叠
