VSCode折叠/展开默认快捷键为Ctrl+Shift+[和Ctrl+Shift+]（Win/Linux）或Cmd+Option+[和Cmd+Option+]（macOS），但效果依赖语言模式、foldingProvider支持及光标位置，非所有文件类型均生效。
折叠/展开代码块的默认快捷键在不同语言下行为不一致
VSCode 的 Ctrl + Shift + [（Windows/Linux）或 Cmd + Option + [（macOS）确实能折叠当前光标所在区域，但实际效果高度依赖语言插件对 foldingRange 的实现。比如 TypeScript 会按函数、类、if 块折叠，而纯文本或未启用语法支持的 .log 文件里这个快捷键根本没反应。
常见错误现象：按下快捷键后“没反应”或只折叠了第一层——不是快捷键坏了，而是当前文件没激活对应语言模式（右下角显示“Plain Text”），或该语言扩展未提供完整折叠规则。
- 确认右下角语言模式正确：点击后选择对应语言（如
TypeScript、Python） - 检查是否禁用了折叠：在设置中搜索
editor.folding，确保editor.folding为true - 部分语言（如 JSON）默认不支持区域折叠，需安装扩展如
JSON Folding
缩进调整快捷键被误用导致格式错乱
Shift + Tab 和 Tab 是最常被误操作的两个键：前者减少缩进，后者增加缩进，但它们作用于**当前行或选中行的起始空白字符**，而非“代码块逻辑层级”。如果选中的是带空行或混合缩进的代码段，结果可能和预期严重不符。
典型问题：用 Tab 对齐一段 Python 代码后，发现 def 下的 return 缩进变成 8 空格；或者 Shift + Tab 把整个 if 块“挤”到左边，破坏了语法结构。
- Python 中务必使用空格而非 Tab：检查右下角缩进指示器，点击切换为
Spaces: 4（或项目约定值） - 批量调整前先全选目标代码（
Ctrl + A或拖选），避免只选中部分行引发偏移 - 若已错乱，可用
Shift + Alt + F触发格式化（前提是配置了 Prettier / Black / autopep8）
折叠图标太小或颜色难辨，影响视觉识别
VSCode 默认折叠箭头是浅灰小三角，在高分辨率屏或深色主题下极易忽略。这不是 bug，而是主题配色与 UI 缩放共同作用的结果。
解决路径很直接：不改主题，只调折叠控件样式。VSCode 允许通过 settings.json 注入 CSS 片段（需启用 workbench.colorCustomizations）：
"workbench.colorCustomizations": {
"editor.foldBackground": "#2a2a2a",
"editorGutter.foldingControlForeground": "#8be9fd"
}
注意：editor.foldBackground 设置的是折叠区域左侧背景色（仅当启用 editor.showFoldingControls: always 时生效），editorGutter.foldingControlForeground 控制箭头颜色。值设为亮色（如 #8be9fd）比默认灰更易定位。
- 修改后需重启窗口或重载窗口（
Ctrl + Shift + P→Developer: Reload Window） - 避免使用过于饱和的颜色，否则在浅色主题下会刺眼
- 某些主题（如 One Dark Pro）会覆盖这些设置，优先尝试关闭主题再测试
自定义折叠区域需要手动标注但容易失效
用 // #region 和 // #endregion 手动标记折叠块，看似灵活，但 VSCode 实际依赖语言服务器是否解析这些注释。JavaScript/TypeScript 默认支持，Python 需要插件（如 Python 官方扩展），而 Shell 脚本或 Markdown 则完全不识别。
现象：写了 #region init 却无法折叠——大概率是当前文件类型没注册 region 解析器。
- 确认语言支持：打开命令面板（
Ctrl + Shift + P），运行Developer: Toggle Developer Tools，在 Console 查看是否有folding range provider相关报错 - Python 用户可安装
vscode-region-folder扩展补全 region 支持 - 不要混用符号：JS/TS 用
// #region，C# 用#region（无双斜杠），写错就失效
真正麻烦的不是怎么设，而是不同项目用不同语言、不同扩展、不同缩进风格时，折叠和缩进行为会突然“变脸”——得一个个查语言模式、扩展状态、设置继承链，而不是指望一个全局开关搞定所有场景。
