VSCode如何配置代码折叠_自定义折叠区域与快捷键

vscode折叠不生效需先确认语言模式和设置：检查右下角语言是否正确，确保”editor.folding”: true、”editor.showFoldingControls”设为”mouseover”或”always”、”editor.foldingStrategy”: “auto”；手动折叠用// #region（js/TS）、#region（python/C#）等语法，注意缩进一致；Python中优先用#region而非# #region；快捷键可自定义keybindings.json。

VSCode 默认折叠规则不生效？先确认语言模式和设置

vscode 的代码折叠能力依赖于当前文件的 language mode（如 javascript、python、html），不同语言的折叠逻辑由对应语法解析器决定。如果 ctrl+shift+[ 或 ctrl+shift+] 没反应，先按 ctrl+shift+p 打开命令面板，输入 change language mode，确认右下角显示的是正确语言（比如不是 plain text）。再检查设置里是否意外关闭了折叠：

• "editor.folding": true（必须为 true，默认开启）
• "editor.showFoldingControls": "mouseover" 或 "always"（控制折叠箭头是否可见）
• "editor.foldingStrategy": "auto"（推荐保持默认，indent 仅靠缩进会误判）

用 // #region 和 // #endregion 手动定义折叠块

这是最通用、跨语言兼容的自定义折叠方式，支持几乎所有主流语言（JS/TS/Python/Java/C#/go 等），VSCode 原生识别，无需插件。

写法注意点：

• 注释符号需匹配当前语言：JS/TS 用 // #region，Python 用 # #region，C# 用 #region（无双斜杠）
• #endregion 必须与 #region 在同一缩进层级，否则折叠无效
• 区域名可选，但建议写明用途，例如 // #region API handlers

// #region Utility functions function formatDate(date) { return date.toISOString().split('T')[0]; } function debounce(fn, ms) { /* ... */ } // #endregion

Python 中 # region 不起作用？改用 #region 或配置 foldingProvider

Python 官方语言服务器（Pylance）默认不识别 # #region（带空格），只认 #region（紧挨着 #）。若仍无效，可能是当前 Python 扩展未启用折叠支持。

解决方法：

• 改写为 #region utils 和 #endregion
• 在 settings.json 中强制指定折叠提供者："python.foldingStrategy": "indent"（退回到缩进模式，但会丢失函数/类级折叠）
• 或安装 Python Docstring Generator 类扩展——部分增强型 Python 扩展会补全 # #region 支持

快捷键冲突或想改键位？直接编辑 keybindings.json

VSCode 折叠相关命令有明确命名，可在命令面板搜索关键词 folding 查看全部。常用命令包括：

• editor.fold → 折叠当前层级（默认 Ctrl+Shift+[）
• editor.unfold → 展开当前层级（默认 Ctrl+Shift+]）
• editor.foldAll → 折叠所有区域（含自定义 #region）
• editor.unfoldAll → 展开全部

修改快捷键：打开命令面板 → Preferences: Open Keyboard Shortcuts (JSON) → 添加类似如下条目：

[   {     "key": "ctrl+k ctrl+0",     "command": "editor.foldAll"   },   {     "key": "ctrl+k ctrl+j",     "command": "editor.unfoldAll"   } ]

注意：自定义折叠区域（#region）只有在 editor.foldAll 时才会被收起；普通 editor.fold 只作用于语法结构（如函数、if 块），不作用于注释标记区域。