sublime中如何实现代码折叠与展开？（结构清晰）-sublime-PHP中文网

Sublime Text 默认仅按语法结构折叠：Python 依缩进、JS/JSON 依{}、HTML 依标签对；不支持注释块或#region，需插件或配置fold_by_level等选项实现。

sublime中如何实现代码折叠与展开？（结构清晰）

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
}

再配合在代码中写：

Gen-2

Gen-2是一款AI视频创作工具，Runway最新推出的AI视频生成模型。

下载

#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：靠标签对折叠，... 可折，但自闭合标签不触发折叠
Markdown：默认不支持折叠；需安装 MarkdownEditing 插件，并启用 "md_fold_enable": true
性能提示：超长 JSON（>10k 行）开启折叠可能卡顿，建议先用 Ctrl+Shift+P → Pretty JSON 格式化再操作

最常被忽略的一点：折叠状态不会跨会话保存。关掉文件再打开，所有折叠都会重置 —— 这不是 bug，是 Sublime 的设计选择，没有“记忆折叠”的内置机制。