如何设置VSCode代码块折叠级别以优化导航体验？

本文共计741个文字，预计阅读时间需要3分钟。

VSCode 没有默认折叠级别这个全局开关，`editor.foldLevel` 只控制初始展开深度，且仅对 import、注释等有效。

为什么 editor.foldLevel 设了也不按预期折叠

这个设置只作用于 VSCode 内置的「大纲层级（outline level）」，而 import 语句在 JavaScript/TypeScript 中不属于大纲节点；Python 的 import 也不生成独立 outline 条目；JSON/YAML 的键值对更不参与 outline 计算。所以：
• 设 "editor.foldLevel": 1 后，JS 文件里 import 依然平铺
• Python 文件中 if 块可能展开，也可能不展开，取决于缩进识别是否被语言服务采纳
• 即使设为 0，也不会让所有内容全折叠——VSCode 不允许折叠到“空”状态

真正能影响初始折叠状态的配置项只有这几个

• "editor.foldingStrategy": "indentation"：强制按缩进计算折叠范围，对 Python/YAML/Markdown 最稳定，但会把同缩进的字符串换行、注释块也当候选，需谨慎
• "editor.showFoldingControls": "mouseover"：只是控制折叠按钮何时显示，不影响行为
• 语言专属设置如 "javascript.preferences.foldingStrategy" 或 "python.foldingStrategy"：比全局设置优先级高，可单独覆盖
• "editor.foldEnable"：总开关，设为 false 会彻底禁用所有折叠控件和快捷键，别误关

想实现“打开即折叠 import + 配置块”，只能靠手动标记或扩展

VSCode 原生不支持基于语义（比如“所有 import 语句”）的自动折叠规则。
• 在 JS/TS 中，用 // #region imports 包裹 import 语句，再配 "editor.foldingStrategy": "auto"，就能稳定折叠
• Python 用户需确认已安装官方 Python 扩展（v2021.9+），并用 #region 和 #endregion（注意不是 ##region）
• 如果必须自动化，目前唯一可行路径是装宏类扩展（如 geddsk.vscode-macros），写脚本监听文件打开事件，然后执行 editor.foldAllBlockComments + editor.foldAllImportStatements（后者仅部分语言扩展提供）
• 别指望 editor.foldLevel 或工作区设置里的 editor.foldImportsWhenOpen——后者根本不是 VSCode 内置配置项，是某些第三方扩展伪造的文档误导

最常被忽略的一点：折叠行为高度依赖当前编辑器右下角显示的语言 ID。.py 文件被识别成 plaintext，哪怕写了 #region 也毫无反应；.yml 文件显示为 yaml 才能触发 indentation 折叠。改完设置后，务必点开语言模式手动选一次，别只信文件后缀。