折叠标记不生效需检查：folding 是否启用、文件绑定的语法是否正确、对应语言是否支持该标记（如Python用#region，JS需插件）、正则匹配是否精确、缩进与空行是否规范。
折叠标记不生效？检查 folding 设置是否被禁用
Sublime 默认只对语言语法定义的结构（如函数、类、if 块）自动折叠，不支持任意区域折叠——除非你手动加标记或改配置。很多人以为加了 // region 就能折，结果点不动，其实是 "fold_enable": false 或语言语法没加载对应规则。
-
"fold_enable": true必须在Preferences.sublime-settings或当前语法的.sublime-syntax中显式启用（默认是 true，但插件或主题可能覆盖） - 确保当前文件绑定了正确语法：右下角显示的是
Python而不是Plain Text，否则// region标记压根不解析 - 部分语言（如 JavaScript）需安装额外包（如
JavaScript Next）才支持// region折叠；原生JavaScript语法默认不识别
// region 和 #region 为什么一个行一个不行？看语法定义
能否用 // region 还是 #region，取决于当前语言的 folding 规则——它写在语法文件（.sublime-syntax）里，不是 Sublime 自己决定的。
- Python 语法默认认
#region和#endregion（注意是#，不是//） - C/C++/C# 用
#region/#endregion；JS（JavaScript Next）用// region/// endregion - 自定义标记必须和语法文件中
folding_start_marker正则完全匹配，比如写成// region foo，但正则只写了// region，那带参数的就不触发
想让任意代码块可折叠？用 fold_level 手动标记 + 插件辅助
纯靠注释标记有局限：不能嵌套、不能跨空行、不支持多语言统一写法。更稳的方式是用 fold_level 指令，配合插件（如 CodeFolding）或手动设置。
- 在行首加
// @fold，再在Preferences → Package Settings → CodeFolding → Settings里配"fold_markers": {"start": "// @fold", "end": "// @endfold"} - 或者直接修改语法文件，在
folding段加："folding_start_marker": "(?i)^\s*//\s*@fold.*$", "folding_end_marker": "(?i)^\s*//\s*@endfold.*$"
- 注意：手动改语法文件后要重启 Sublime，且每次升级语言包可能被覆盖
折叠后光标跳转错乱、展开失效？大概率是缩进或空行干扰
Sublime 的折叠依赖行首缩进一致性与连续性。哪怕只是中间夹了一行空行、或某行缩进多了一个空格，整个区域就无法识别为合法折叠块。
- 折叠起始行和结束行必须有相同层级缩进（比如都顶格，或都缩进4空格），不能混用 Tab 和空格
-
// region后面不能紧跟非空字符（如// region:utils可能失败，改成// region utils更稳） - 如果折叠后点击箭头没反应，打开
View → Show Console，执行view.fold(view.sel()[0])看是否报None—— 报这个说明 Sublime 根本没识别到可折叠范围
Sublime 的折叠不是“所见即所得”的编辑器功能，它本质是语法解析器的一次静态扫描。标记写得再整齐，只要语法定义没覆盖、缩进有偏差、或当前文件没绑定对的语言，就白搭。最省事的做法：先确认右下角语法名，再查对应语言的折叠文档，别硬套其他编辑器的习惯。
