Sublime自定义折叠仅有三种可靠方式：1. fold_selection手动折叠任意选中区域；2. indentation_based_folding按缩进层级折叠；3. 修改.sublime-syntax添加foldingStart/StopMarker规则。
Sublime 里所谓“自定义折叠”，实际只有两种可靠路径：一种是绕过语法解析、直接对选中行生效的 fold_selection，另一种是修改语法定义或启用 indentation_based_folding 实现结构级控制——不存在“随便写个注释就能折”的开箱即用方案。
手动折叠任意选中区域（最稳，不依赖语法）
这是唯一 100% 可控、无需改设置、不装插件、不看作用域的兜底方式。适用于 JSON 配置、日志块、base64 字符串、大段注释等非标准结构。
- 鼠标拖选你要收起的连续多行（支持跨函数、跨括号、甚至跨文件类型）
- Windows/Linux 按
Ctrl+Shift+Alt+[，macOS 按Cmd+Ctrl+Option+[ - 侧边栏 gutter 立即出现独立三角图标，点击即可展开/收起
- 该折叠仅存于当前会话；关闭文件即丢失，
Ctrl+K, Ctrl+J不会还原它
启用基于缩进的折叠（适合 Python/YAML 等语言）
indentation_based_folding 是 Sublime 原生支持的替代方案，它把相同缩进层级的连续代码块视为一个可折叠单元，和 def 或 { 无关——但必须手动开启，且默认不启用。
- 打开
Preferences → Settings – Syntax Specific（确保当前是目标文件，如 .py） - 在右侧用户设置中添加：
"indentation_based_folding": true - 保存后，光标停在某行，按
Ctrl+Shift+[即可折叠该缩进层级及其所有子块 - 注意：全局启用可能干扰 JS/HTML（它们依赖括号匹配），建议按语言单独配置
修改语法定义实现 region 折叠（需动手改 .sublime-syntax）
Sublime 原生不识别 // region 或 <!-- fold -->。想让它生效，必须在语法文件中显式声明 foldingStartMarker 和 foldingStopMarker 正则规则。
- 先通过
Ctrl+Shift+P → View Package File找到当前语言语法（如Python/Python.sublime-syntax） - 复制该文件到
Packages/User/Python.sublime-syntax（避免被更新覆盖） - 在
contexts下添加 folding 规则，例如为 Python 加入：foldingStartMarker: '^(\s*)#\s*region\b'<br>foldingStopMarker: '^(\s*)#\s*endregion\b'
- 重启 Sublime 或重新加载语法（切标签页再切回），
# region行才可能触发折叠
为什么 fold_by_level 有时不按预期工作？
fold_by_level 看似可控，实则完全依赖语法高亮器输出的 scope 链深度。同一份 Python 代码，在装饰器换行、docstring 紧贴 def、或混用 Tab/空格时，meta.function 作用域可能断裂或偏移层级，导致 Ctrl+K, Ctrl+2 对某个函数静默失败。
- 验证方法：光标停在
def行，按Ctrl+Shift+P → Developer: Show Scope Name，确认输出含meta.function.python - 修复优先级：统一用空格缩进 → 装饰器与
def间加空行 → 禁用冲突插件（如旧版 Python Improved） - 输错数字（如
Ctrl+K, Ctrl+9）无提示，只会静默失败；必须严格按Ctrl+K松开后再按数字键
真正容易被忽略的是：所有语法级折叠都卡在右下角那个状态栏上——显示 Plain Text 时，foldingStartMarker 再全也没用。别调设置，先点它，选对语言名。
