sublime text 默认仅按语法结构折叠：python 依缩进、js/json 依{}、html 依标签对；不支持注释块或#region，需插件或配置fold_by_level等选项实现。
Sublime Text 默认支持哪些代码折叠方式
Sublime Text 原生只对特定语法结构做折叠，不是所有缩进或大括号都能自动折叠。它依赖 fold_level 和语法定义里的 fold 指令，比如 Python 靠缩进、JavaScript/JSON 靠 {}、HTML 靠标签对。但像注释块、自定义区域（如 // #region）默认不支持。
常见错误现象：Ctrl+Shift+[ 没反应，或只折了函数体却折不了类、注释、import 块——这不是 bug，是语法高亮定义没配折叠规则。
- 检查当前文件的语法：右下角看是否显示正确语言名，比如 “Python” 而不是 “Plain Text”
- 确认语法包是否完整：某些第三方语法（如 Vue 单文件组件）需额外安装插件才能启用折叠
- 折叠层级受
fold_level限制，默认最多折到 level 4；可通过修改Preferences → Settings – Syntax Specific加入"fold_level": 6
如何手动标记可折叠区域（#region / #endregion）
Sublime Text 本身不识别 #region，但可通过插件或正则注入折叠逻辑。最轻量的方式是用 BracketHighlighter 或原生 fold_by_level 配合自定义正则。
实操建议（无需插件）：
- 打开
Preferences → Settings – Syntax Specific，添加以下内容（以 Python 为例）：
{
"fold_by_level": true,
"fold_on_indent": false,
"fold_comments": true,
"fold_functions": true
}
再配合在代码中写：
-
#region 初始化配置—— 这行会被当作折叠起始（需搭配插件CodeFolding或AdvancedNewFile） - 更可靠的做法：用空行 + 注释分隔，然后开启
"fold_by_level": true，靠缩进层级折叠 - 注意：
#endregion不会被识别，Sublime 不解析成对注释；真正起作用的是缩进深度或括号匹配
折叠快捷键与鼠标操作失效的排查点
快捷键失灵往往不是 Sublime 的问题，而是上下文冲突或设置覆盖。
-
Ctrl+Shift+[折叠、Ctrl+Shift+]展开 —— 在 macOS 是Cmd+Shift+[，别按错 - 如果光标在字符串或注释内，折叠会失效（Sublime 默认不折字符串内部）
- 某些插件（如
GitGutter或SideBarEnhancements）可能劫持快捷键，临时禁用插件测试 - 检查是否启用了
auto_indent或detect_indentation：缩进混乱时，折叠层级计算会出错
JSON / HTML / Markdown 中折叠行为差异
不同语法的折叠机制完全不同，不能套用同一套理解。
- JSON：只认
{}和[]，字段名和值之间无法折叠；"data": [ ... ]可折数组，但"name": "xxx"不可折 - HTML：靠标签对折叠，
<div>...</div>可折，但<img alt="sublime中如何实现代码折叠与展开？（结构清晰）" >自闭合标签不触发折叠 - Markdown：默认不支持折叠；需安装
MarkdownEditing插件，并启用"md_fold_enable": true - 性能提示：超长 JSON（>10k 行）开启折叠可能卡顿，建议先用
Ctrl+Shift+P → Pretty JSON格式化再操作
最常被忽略的一点：折叠状态不会跨会话保存。关掉文件再打开，所有折叠都会重置 —— 这不是 bug，是 Sublime 的设计选择，没有“记忆折叠”的内置机制。
