VSCode如何开启并配置自动折叠功能_VSCode长代码阅读法【技巧】

VSCode 其实并没有一个叫“自动折叠”的开关。你听到的“自动”，本质上是通过正确配置 foldingStrategy、依赖语言扩展，再配合 #region 标记规则，共同触发的一种折叠行为。开箱即用的情况下，它只对 function、class 这类语法块生效，其他的场景，要么手动调整，要么就得靠扩展来实现了。

光标明明在函数里，为什么没出现▶折叠图标？

这大概率是 editor.showFoldingControls 被设置成了 "never"，或者干脆把 editor.folding 给关掉了。VSCode 不会报错，只会默默地把所有折叠按钮都藏起来。排查方法很简单：打开 settings.json（快捷键 Ctrl+Shift+P，输入 Preferences: Open Settings (JSON)），确认下面这两项有没有配对：

• "editor.folding": true
• "editor.showFoldingControls": "mouseover"（推荐，节省界面空间；如果经常手动选区折叠，也可以用 "always"）

另外，还得看一眼右下角的语言标识——比如 .py 文件应该显示的是 Python，而不是 Plain Text；.jsonc 文件对应的应该是 JSON with Comments。如果语言选错了，折叠功能自然也不会工作。最后，某些格式化扩展（比如旧版的 Prettier）偶尔会干扰折叠渲染，可以临时禁用一下做个测试。

如何让 JSON/YAML/Markdown 按缩进折叠？

这类语言没有 {} 或 def 这样的语法锚点，"auto" 策略基本派不上用场。必须强制切换到 "indentation" 模式，VSCode 才会老老实实地按空格或 TAB 层级来折叠。不过，全局设置（"editor.foldingStrategy": "indentation"）需要谨慎，更推荐的做法是按语言精准控制，在 settings.json 里加上：

• "[json]": { "editor.foldingStrategy": "indentation" }
• "[yaml]": { "editor.foldingStrategy": "indentation" }
• "[markdown]": { "editor.foldingStrategy": "indentation" }

需要注意，HTML/CSS 即使设置了 indentation，也可能回退到语法折叠——这是内置解析器优先级更高，不是配置错了。

// #region 折叠写了却不生效？检查这几点

VSCode 是原生支持 #region 标记的，但它对格式的要求相当“死板”——必须单行注释开头，紧接着 region 字样，而且不同语言规则还不同。写错一个空格、多一个斜杠、缩进不一致，它就直接忽略掉。具体来说：

• Ja vaScript/TypeScript 的正确写法：// #region API handlers（两个斜杠 + 空格 + #region）
• Python/C# 的正确写法：#region utils（一个井号 + 紧跟 region，不能写成 # #region）
• #endregion 必须和 #region 处于同一缩进层级，否则无法闭合
• 确保对应语言扩展已启用：比如 Python 需要官方扩展，并且 python.foldingStrategy 设为 "auto"；JS/TS 需要 TypeScript Server 正常工作
• "auto" 是前提："indentation" 模式下 // #region 完全不识别

连续空行能自动收起来吗？不能，但可以模拟

VSCode 本身并不支持自动折叠连续空行。这确实是个遗憾，但也不是完全没有办法。首先，需要把 "editor.showFoldingControls" 设为 "always"，这样在行号旁边就能看到折叠箭头了。然后手动选中若干空行（比如连续 3 行），按 Ctrl+Shift+[（Windows/Linux）或 Cmd+Shift+[（macOS）即可折叠。如果想实现“默认收起”，那就只能靠扩展了，比如 Auto Fold（作者 Aidan W.）。安装后在 settings.json 里添加配置示例："auto-fold.rules": [ { "begin": "^\s*$", "end": "^\s*$" } ]。不过要注意，大文件（超过 5000 行）可能会卡顿，而且如果同时开启了其他折叠扩展（比如 indent-rainbow），也可能出现冲突导致箭头错位。

还有一点容易被忽略：折叠状态并不会跨会话保存。每次打开文件，所有代码块都是默认展开的。如果需要记住上次的折叠位置，要么靠插件（比如 Restore Folding），要么手动执行 Ctrl+K Ctrl+0 再 Ctrl+K Ctrl+J 快速复位。经验表明，这才是真正能提升效率的“隐藏技巧”。