vscode代码折叠失效的三大主因是语言模式识别错误、折叠策略不匹配及折叠控件被关闭；需检查editor.folding、editor.showfoldingcontrols和editor.foldingstrategy三项设置是否正确启用并配置。
VSCode 的代码折叠功能默认开启，但多数人遇到的“不折叠”“点不动”“快捷键失效”，根本原因不是功能坏了，而是语言模式识别错、策略没对齐、或者折叠控件被关了——不是要装插件，是得调对三个关键设置。
为什么光标放在函数上没出现 ▶ 折叠图标
折叠控件消失，90% 是因为 editor.showFoldingControls 被设成了 "never"，或者 editor.folding 被意外关掉。VSCode 不会提示你这个开关被关了，只默默隐藏所有折叠按钮。
- 打开
settings.json（Ctrl+Shift+P →Preferences: Open Settings (JSON)），确认这两项存在且为 true： "editor.folding": true-
"editor.showFoldingControls": "mouseover"或"always"（推荐mouseover，省空间） - 检查右下角语言标识是否正确：比如
.py文件显示的是Python，不是Plain Text；.jsonc文件应为JSON with Comments，否则大括号不识别 - 如果用了 Prettier、ESLint 等格式化扩展，某些旧版本会劫持折叠渲染，可临时禁用验证
怎么让 JSON/YAML/Markdown 按缩进折叠
这些语言没有 {} 或 def 这类语法锚点，"auto" 策略基本失效。必须强制切到 "indentation" 模式，VSCode 才会老老实实数空格/TAB 层级。
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 全局生效（慎用）：
"editor.foldingStrategy": "indentation" - 按语言精准控制（推荐）：在
settings.json里加语言专属配置，例如： "[json]": { "editor.foldingStrategy": "indentation" }"[yaml]": { "editor.foldingStrategy": "indentation" }"[markdown]": { "editor.foldingStrategy": "indentation" }- 注意：HTML/CSS 即使设了
indentation，也可能回退到语法折叠——这是内置解析器优先级更高，不是配置错了
// #region 折叠为什么写了却不生效
VSCode 原生支持 #region，但只认「单行注释开头 + 紧跟 region」的写法，且不同语言规则不同。写错一个空格、多一个斜杠、缩进不一致，就直接忽略。
- JavaScript/TypeScript 正确写法：
// #region API handlers（两个斜杠 + 空格 + #region） - Python 正确写法：
#region utils（一个井号 + 紧跟 region，不能写成# #region） - C# 正确写法：
#region Helpers（同 Python） -
#endregion必须和#region处于同一缩进层级，否则折叠区域无法闭合 - 若仍不生效，检查对应语言扩展是否启用：比如 Python 需 Pylance，TS 需 TypeScript Server；禁用后重开文件再试
折叠快捷键按了没反应？先看光标在哪
VSCode 的 Ctrl+Shift+[ 和 Ctrl+Shift+] 不是全局生效，它只作用于“当前光标所在的可折叠结构”。光标停在空白行、字符串内、或非折叠边界行，快捷键就静音。
- 有效触发位置举例：
- JS 中：光标在
function foo() {行、if (x) {行、或{所在行 - Python 中：光标在
def/class/for/if行（且该行缩进层级有下一级） - JSON 中：光标在
{或[所在行 - 批量操作更可靠：
Ctrl+K松开 →Ctrl+0（全部折叠），Ctrl+K松开 →Ctrl+J（全部展开） - 大文件（>5000 行）可能自动禁用折叠，可在设置中调高
editor.foldingMaximumRegionLength
最常被忽略的一点：折叠策略（foldingStrategy）和折叠总开关（folding）是两层独立控制。关掉 folding，再好的策略也白搭；设对了 indentation，但 showFoldingControls 是 never，你就永远找不到那个小三角。
