Sublime折叠标记需满足语言识别正确且语法定义支持；Python/JS可通过语法特定设置启用注释折叠；fold_selection是唯一任意折叠方式；自定义标记有风险，推荐用条件块或缩进折叠。
折叠标记不生效？先确认语言识别和语法定义
Sublime 的 <!-- fold --> 和 <!-- endfold --> 这类注释标记不是通用开关，它只在当前语言的语法定义中显式支持时才起作用。常见误区是直接在 Python 文件里写 // <!-- fold -->——Python 不认 //，而原生 Python 语法包默认根本没启用 fold_comments 规则。
必须满足两个前提：
- 右下角状态栏显示的是真实语言名（如
Python、JavaScript），不是Plain Text或插件提供的别名（如Python Improved） - 该语言的
.sublime-syntax文件里定义了foldingStartMarker和foldingStopMarker，且匹配你写的标记格式
验证方式：按 Ctrl+Shift+P → 输入 View Package File → 打开当前语言文件（如 JavaScript/JavaScript.sublime-syntax）→ 搜索 folding。若无结果，说明该语法不支持注释折叠。
怎么让 Python/JS 支持 #region 和 /* region */？
原生 Sublime 不支持 #region（Python）或 /* region */（JS），但可通过语法特定设置启用注释折叠机制：
- 对 Python：打开
Preferences → Settings – Syntax Specific，在右侧加"fold_comments": true，然后用# region description和# endregion包裹代码 - 对 JavaScript/JSON/CSS：同样设
"fold_comments": true，再用/* region description */和/* endregion */ - 注意：这些注释必须位于可被识别为 comment scope 的位置（即不能在字符串、正则字面量或 JSX 表达式内部）
如果写了但没反应，按 Ctrl+Shift+P → Developer: Show Scope Name，光标停在 # region 行，看输出是否含 comment.line.number-sign.python 或 comment.block.js。不含？说明注释未被语法识别，标记自然无效。
fold_selection 是唯一真正任意折叠的方式
当标记失效、语法不支持、或你只想临时收起一段日志/配置/测试数据时，fold_selection 是最可靠的选择——它完全绕过语法解析和缩进校验。
- 鼠标拖选任意连续多行（哪怕全是空行或 JSON 字符串）
- Windows/Linux 按
Ctrl+Shift+Alt+[，macOS 按Cmd+Ctrl+Option+[ - 侧边栏立刻出现独立三角图标，点击即可展开/收起
这个折叠仅存于当前会话，关闭文件即消失；Ctrl+K, Ctrl+J（unfold_all）不会还原它，必须手动点开。它不写入磁盘、不依赖任何设置，适合紧急整理和快速遮蔽干扰内容。
自定义折叠标记的风险与替代方案
想硬加 <!-- fold --> 到 YAML 或 Markdown？可以改 Packages/User/YAML.sublime-syntax，插入 foldingStartMarker 正则，但有明显代价：
- 每次语言包升级，你的修改会被覆盖，需手动同步
- 正则写错会导致整块语法高亮异常（比如所有字符串变白）
- 折叠行为可能与其他插件冲突（如 BracketHighlighter 对括号的处理）
更稳妥的替代方案：
- 用
if False:（Python）或#if 0（C/C++）包裹目标段——Sublime 原生识别这些为条件块，稳定可折 - 用
fold_by_level配合统一缩进（如把配置块缩进 4 空格，再执行fold_by_level 4） - 接受“不折叠”，优先删冗余、拆函数、命名清晰——Sublime 的折叠机制只反映语法骨架，它不替你做设计决策
真正容易被忽略的是：折叠状态是视图级缓存，重启 Sublime 后全部展开；且鼠标悬停折叠标记显示的行号是原始行号，跳转后光标落在折叠行首，不是你记忆中的某行。
